qingsongping-AIDevelop/docs/r01-b-error-status-mapping-instruction.md

R01-B 业务异常 HTTP 状态映射收束实施指令

1. 目标

在不改变任何对外行为的前提下，将 GlobalExceptionHandler.resolveHttpStatus 的长 if 链收束为集中、不可变、可完整验证的整数业务码映射。

2. 硬边界

• 不修改 ErrorCode 的常量、数值或文案；
• 不新增接口、Flyway、表、索引、依赖；
• 不改变 HTTP 状态、响应业务码、message、requestId 或兜底语义；
• 必须继续按整数业务码解析，因为历史常量可能共享数值；
• 同一整数码若被登记为不同 HTTP 状态，应用初始化必须失败，不能静默覆盖；
• 未显式登记的整数码继续返回 HTTP 400；
• 不进入 R01-C/D/E，不提交、不推送。

3. 测试门槛

先建立全量特征测试，对 ErrorCode.values() 每个常量逐一断言 HTTP 状态、业务码、message、requestId，并单独验证未知整数码回退 400。随后运行异常关联测试、mvn clean verify 与静态 OpenAPI 校验，Failures/Errors/Skipped 必须全部为 0。