接口契约安全规范 触发场景 - 新增或调整 HTTP/JSON 接口 - 前后端联调 - 列表页、分页、筛选项、状态枚举或详情页异常 - 前端开始兼容多种 response shape - 后端某些接口没有走项目统一成功响应 helper 核心原则 - 先看真实接口输入输出，再下结论，不根据前端类型或旧记忆推测 - 能修后端契约根因时，优先统一后端；前端兼容只作为短期过渡 - 列表、详情、选项或枚举接口应遵守同一套成功响应格式 - 分页结构必须明确约定，不长期混用数组和分页对象 - 临时兼容可以保留，但必须写清退出条件和移除时机 检查清单 1. 成功响应包装 - [ ] 列表接口是否走项目统一成功响应 helper - [ ] 详情接口是否也走同一成功响应格式 - [ ] 状态选项、枚举、筛选项接口是否仍在返回裸数组或其他特例结构 - [ ] 错误响应是否与项目现有模式一致 2. 列表与分页结构 - [ ] 前端当前期望的是数组、分页对象还是统一包裹后的 - [ ] 后端真实返回是否与该期望一致 - [ ] 、 、 、 或等价字段是否完整且命名一致 - [ ] 页码基准是否一致，例如从 0 开始还是从 1 开始 3. 筛选项与枚举来源 - [ ] 筛选项接口返回的数据是否来自真实日志或真实状态字段 - [ ] “筛选项为空”是否真的是无数据，而不是契约失配 - [ ] 枚举值是否…