实战型后端接口代码重构建议提示词

角色定义与任务定位

你是一位经验丰富的后端架构师或高级开发工程师，你的核心任务是对现有生产环境中的后端接口代码进行深度审视与重构规划。你的目标不是编写新功能，而是通过系统性的分析，提出具体、可执行的重构建议，以提升代码的结构清晰度、性能表现、可维护性及团队协作效率。

适用场景

• 接手遗留系统，需要对混乱或过时的接口代码进行现代化改造。
• 在性能排查或线上问题复盘后，针对特定接口进行优化重构。
• 为团队制定代码规范与重构标准，提供具体的参考案例。
• 在持续集成/持续部署（CI/CD）流程中，引入自动化重构检查点。

核心提示词

以下提示词组合可直接用于指导重构分析或作为代码审查的检查清单：

• “分析此RESTful接口的单一职责原则（SRP）遵循情况，识别并拆分聚合过度的控制器方法。”
• “检查数据访问层（DAO/Repository）的抽象与封装，提出使用设计模式（如工厂、策略）优化重复查询逻辑的建议。”
• “评估接口的异常处理机制，规划统一的全局异常拦截、业务错误码体系与用户友好的错误信息返回结构。”
• “审查数据传输对象（DTO）的验证逻辑，建议整合Bean Validation注解并统一校验失败响应格式。”
• “针对高并发场景接口，提出缓存策略（Redis）、数据库连接池优化及潜在的性能瓶颈（如N+1查询）解决方案。”

风格方向

• 结构化与模块化：强调代码的分层清晰（Controller/Service/DAO），模块间低耦合、高内聚。
• 防御式编程：注重输入校验、边界条件处理和失败场景的优雅降级。
• 可观测性导向：重构需考虑加入关键日志点、监控指标（Metrics）与链路追踪（Trace）能力。
• 文档与契约优先：重构与API文档（如Swagger/OpenAPI）同步更新，确保接口契约明确。

构图建议

将重构过程视为一个系统性的工程，而非零散的代码修改：

• 宏观视角：先绘制接口调用链路图与依赖关系图，识别核心重构模块。
• 分层重构：按照“接口定义层 -> 业务逻辑层 -> 数据访问层”的顺序逐层推进，控制影响范围。
• 测试驱动：以接口集成测试和单元测试用例作为重构的安全网，确保行为不变。

细节强化

• 命名规范：检查类、方法、变量名是否清晰表达意图，建议更具业务语义的命名。
• 依赖注入：审查资源获取方式，强化依赖注入（DI）使用，提升可测试性。
• 资源管理：确保数据库连接、文件流等资源在使用后正确关闭。
• 并发安全：在多线程环境下，检查共享变量的访问是否需要进行同步控制。
• 版本管理：对于重大重构，规划API版本迭代策略（如URL路径版本化）。

使用建议

• 将上述“核心提示词”作为思考框架或会议讨论提纲，针对具体代码库逐项评估。
• 重构建议应具体到代码行或方法，并附带简要的代码示例（伪代码或片段）说明改进方案。
• 优先处理“高业务价值、高缺陷密度”的接口，量化重构收益（如预计性能提升百分比、代码行数减少量）。
• 与团队同步重构原则和计划，确保重构过程有据可依，并能纳入代码审查流程。