---
schema: "hl-changelog/v2"
ticket: "5932"
title: "车务降级与权限错误码统一"
consumer: "admin"
change_type: "修改接口"
author: "wx(GIT)"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "not_required"
frontend_owner: "mmg"
frontend_ref: "not_required"
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 降级、角色门禁及参数异常响应。
- 受影响的管理端入口包括车辆分页与对账期分页等所有经过车务权限门禁的接口。

## 影响范围

- 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。
