高阶版后端接口代码生成调试提示词

角色定义

你应扮演资深后端架构师兼代码生成专家，拥有多年微服务、高并发场景下的接口设计与调优经验。
核心目标：利用这组提示词，引导AI生成可直接部署、鲁棒性强、注释清晰的后端接口代码，并具备快速定位与修复问题的调试能力。
重点关注代码的可维护性、安全性、性能基准以及团队协作规范，避免生成“能跑就行”的粗糙实现。


适用场景

需要为新业务模块快速搭建符合RESTful/GraphQL标准的CRUD接口。
在已有接口基础上进行性能瓶颈定位、异常边界扩展或日志链路增强。
团队内部统一接口代码风格，减少代码Review中因规范不一致导致的反复修改。
自动化测试、压力测试前需要生成带完整Mock数据和断言逻辑的接口桩代码。
与AI结对编程时，需要精准表达接口参数约束、状态码设计、错误码枚举等复杂要求。


核心提示词（可直接复制使用）

基础接口生成：“请生成一个Controller层方法，路径为/api/users/{id}，GET请求，返回用户详情对象。要求：使用Spring Boot + MyBatis-Plus，参数校验（@Validated），自定义异常抛出，SLF4J日志记录入参和耗时。响应格式为统一封装类Result，状态码200正常，404表示用户不存在，500内部错误。” 
调试增强生成：“为上述接口添加调试上下文：在方法开头注入TraceId，通过AOP记录请求入参与返回值，当响应时间超过1秒时输出WARN级别日志并触发一个自定义监控指标。同时添加断言注释，说明每个if分支的触发条件与对应的HTTP Status Code。” 
重构与优化提示：“现有接口查询耗时超过500ms，请按以下规则优化代码：将数据库查询改为批量查询+本地缓存，增加降级策略（熔断器阈值设为10次失败），移除冗余的循环调用，并用CompletableFuture异步处理非核心数据填充。要求保留原始接口签名，注释标注每个优化点的理论收益。”


风格方向

命名规范：严格遵循CamelCase（Java）/ SnakeCase（Python），类名、方法名、变量名在注释中标注全称含义。
注释密度：关键业务逻辑、复杂判断、边界处理处必须附带中文注释，注释内容应说明“为什么这么做”而非“做了什么”。
设计模式：推荐分层架构（Controller/Service/Repository/DTO），对高复用逻辑使用策略模式或模板方法，避免if/else嵌套超过3层。
异常处理：统一使用全局异常处理器，自定义业务异常继承RuntimeException，携带code和message，禁止catch后吞掉异常。


构图建议（代码结构组织）

方法逻辑分区：使用空行和注释块将方法分为“参数校验区”“核心逻辑区”“异常兜底区”，每个区域最多5~8行代码。
层级缩进：每层缩进4空格，DTO字段按重要程度降序排列，相同类型字段连续排列。
请求链路可视化：在重要接口的起始行添加结构注释，如 // ===== Step1: 鉴权 =====，便于快速扫描执行顺序。
调试标记：在可能出错的点旁边添加 // TODO 调试：关注此处空指针风险 或 // DEBUG: 此处返回可能为null，需确认上游保证。


细节强化

安全性：所有对外接口自动注入SQL防注入、XSS过滤（使用框架过滤器），密码等敏感字段在日志中脱敏（掩码处理）。
性能：打开慢查询日志阈值，在Dao层添加@Cacheable并配置过期时间（建议30秒），对列表接口强制分页，防止全表扫描。
可观测性：注入Micrometer指标，记录接口QPS、P99延迟、错误率；健康检查端点返回数据库连接池状态。
调试便利性：支持通过请求头传入 X-Debug: true 来开启详细堆栈输出（仅非生产环境），方便本地联调。


使用建议

分段对话：不要一次性要求AI生成整个模块，先让AI生成接口骨架，再逐段增加调试、优化、异常处理等细节，便于迭代微调。
提供上下文：在提示词前附上一小段当前项目技术栈的描述（如Spring Boot 3.2 + JDK 21 + PostgreSQL 16），减少AI对环境的猜测。
验证输出：生成的代码务必在本地或沙箱环境运行单元测试与简易压测，特别关注幂等性（幂等Key生成）、并发竞态（乐观锁版本号）等隐性缺陷。
反馈闭环：若AI生成了不符合预期的代码（如错误的返回格式），直接在下次提问中引用错误位置并要求用补丁方式修正，不要全量重写，以保持对话连续性。