diff --git a/changelogs-v2/2026-08/13_5932_车务降级与权限错误码统一-修改接口-管理后台.md b/changelogs-v2/2026-08/13_5932_车务降级与权限错误码统一-修改接口-管理后台.md new file mode 100644 index 0000000..922427b --- /dev/null +++ b/changelogs-v2/2026-08/13_5932_车务降级与权限错误码统一-修改接口-管理后台.md @@ -0,0 +1,41 @@ +--- +schema: "hl-changelog/v2" +ticket: "5932" +title: "车务降级与权限错误码统一" +consumer: "admin" +change_type: "修改接口" +author: "wx(GIT)" +backend_status: "deployed" +gateway_status: "verified" +frontend_status: "pending" +frontend_owner: "mmg" +frontend_ref: "pending" +target_release: "v2.1" +verified_at: "2026-08-13" +updated_at: "2026-08-13" +status_note: "PR #5950 已合并 dev-v3,fleet 测试服部署任务 30cb1e1b 成功;车辆分页和对账期分页网关只读实测 HTTP/code 200。" +base: "dev-v3" +--- + +# 车务降级与权限错误码统一(#5932) + +## 影响范围 + +- fleet 调权限、文件、团期资源、订单服务的 Feign 降级响应统一为可稳定识别的六位业务码。 +- 日快照回调区分瞬时失败 `605711` 与永久 4xx `605712`:前者重试,后者立即隔离。 +- 未认证/无权限分别保留真实 HTTP 401/403;超级管理员业务权限拒绝仍为 HTTP 200 + 业务码 `403001`。 +- 参数绑定错误统一 HTTP 200 + `100001`,类型错误文案补字段和日期格式提示。 + +## 前端适配 + +- Feign 服务不可用按响应 `code` 处理,不依赖中文 message。 +- HTTP 401/403 继续由登录/权限公共处理器接管。 +- `403001` 是业务权限码,不等于 HTTP 403。 + +## 验证证据 + +- PR `#5950`,squash merge `453540c7`。 +- 聚焦 75/75,ArchTest 13/13,spotless 通过。 +- MockMvc 真实验证 HTTP 401/403。 +- Deploy Panel `30cb1e1b` 成功。 +- 网关只读:`GET /admin/fleet/vehicles/page`、`GET /admin/fleet/reconciliation/periods` 均 HTTP 200 / code 200。