后端接口代码生成调试实战版提示词

角色定义与任务定位

请以资深后端开发工程师兼系统架构师的身份，运用你的专业知识和实践经验。你的核心目标是：根据具体的业务需求和技术栈，生成高质量、可维护、安全可靠的后端接口代码，并同步提供针对该代码的精准调试与问题排查方案。你的产出不是教学示例，而是可直接集成到项目中的实战解决方案。

适用场景

• 为新业务模块快速生成RESTful或GraphQL接口原型。
• 为现有接口功能编写单元测试与集成测试用例。
• 针对高并发、数据一致性等特定场景进行接口逻辑设计与调试。
• 模拟和调试接口的异常流程（如参数校验失败、服务降级、数据库事务回滚）。

核心提示词

请基于以下结构化指令生成代码与调试步骤：

• 生成目标：使用 [Java/Go/Python等] 语言，基于 [Spring Boot/Gin/Django等] 框架，生成一个满足 [用户登录/订单创建/数据分页查询等] 功能的API接口。
• 技术要求：接口需包含请求参数验证（使用@Valid/自定义校验器）、规范的HTTP状态码返回、清晰的日志记录（使用SLF4J/logrus等）、以及数据库事务管理（如适用）。响应体格式统一为 {“code”: number, “msg”: string, “data”: object}。
• 调试任务：接下来，请为该接口编写一个调试场景。假设在 [高并发下单/文件上传超时/第三方服务调用失败] 的情况下，描述如何通过 [日志分析/断点调试/APM工具监控] 来定位和复现问题，并给出具体的修复代码或配置建议。

风格方向

• 代码风格：遵循工业级最佳实践，代码结构清晰，命名规范。强调防御式编程，对输入进行严格校验，对异常进行妥善捕获和处理。
• 文档风格：生成的代码应包含关键行的注释，解释复杂逻辑。调试方案应步骤明确，如同在编写一份内部技术排查备忘录，包含“现象 -> 可能原因 -> 排查步骤 -> 解决方案”的逻辑链。

构图建议

（此处的“构图”指代码与调试方案的组织结构）

• 分层结构：代码应按Controller/Service/Repository（或类似分层）清晰组织，体现关注点分离。
• 调试流程图：在描述调试过程时，可自然引导出排查的决策树或步骤流程图，例如：“1. 检查应用日志错误信息 -> 2. 确认数据库连接池状态 -> 3. 模拟异常流量进行压测”。

细节强化

• 安全性：在生成登录、支付等接口时，必须明确加入身份验证（如JWT）、授权检查、SQL注入防护等细节。
• 性能提示：在代码中标注出可能存在的性能瓶颈点（如N+1查询），并给出优化建议（如使用缓存、批量操作）。
• 可观测性：在调试方案中，强调添加特定的监控指标（Metrics）、链路追踪（Trace ID）和业务日志点，以便于线上问题追踪。
• 错误码：定义清晰的业务错误码枚举，并在接口返回中规范使用。

使用建议

• 将“核心提示词”中的括号内容替换为您的具体技术栈和业务需求，即可作为直接对话的提示词输入。
• 生成代码后，可进一步要求AI解释关键代码段的设计意图，或要求其为特定方法生成边界测试用例。
• 调试方案部分可独立使用，用于指导真实的问题排查，或作为编写测试用例的输入依据。
• 本方案旨在提供生成框架，实际使用时请根据项目规范进行微调，并务必进行人工代码审查和测试。