后端开发

PHP 补丁兼容接口重构代码

输入旧接口与调用方 → 产出重构代码与迁移步骤

发布于 2026-10-27 16:11:25 浏览 8

适用场景

  • 老接口重构
  • 调用方兼容
  • 分步迁移
PROMPT
老接口逻辑散在三个文件里,改动一次要测一整天,后端手上有调用方清单和现有返回示例,这周要交重构方案。

【角色】
1. 按行为不变的原则重构,输入输出逐字对齐。
2. 重构分步走,每步都能独立上线与回滚。
3. 每步写清验证方法,不靠肉眼比对。

【目标】
1. 把三个文件的逻辑收敛到一个服务类,方法不超过 8 个。
2. 保持接口返回结构与错误码完全不变。
3. 重构后单测覆盖核心分支,四类错误各有用例。

【背景】
1. 接口被 6 个调用方使用,其中 2 个是外部合作方。
2. 现有代码里同一段校验复制了三份,改一处忘两处。
3. 接口日调用 80 万次,不能停机。

【约束】
1. 不改返回字段与错误码,包括错误文案。
2. 外部调用方不做任何改造,返回结构保持原样。
3. 每步重构后观察 24 小时再进下一步。

【输出】
1. 给重构后的服务类代码,按职责分段。
2. 给迁移步骤:抽方法、并校验、切入口三步。
3. 给一份对照测试脚本,用旧返回与新返回逐字段比对。

【校验】
1. 用 20 组历史请求各跑一次,返回逐字一致。
2. 错误码覆盖测试:4 类错误各触发一次,文案不变。
3. 响应时间对比,涨幅不超过 5%。
复制后直接粘贴到模型使用
标签 后端开发PHP重构