核对接口文档和前端字段

示例：接口字段一致性核对报告（示意） 一、核对概况 文档：用户中心接口文档 v2.3（示意版本）；代码：src/api/user.js（示意路径）；核对范围：请求参数＋响应字段；重点类型：缺失、类型不符、命名不一致。 二、前后端字段对照表 接口 | 字段 | 文档类型 | 代码类型 | 文档必填 | 代码是否必传 | 结论 GET /user/detail | userId | string | number | 是 | 是 | 类型不符 GET /user/detail | userName | string | string | 是 | 是 | 命名不一致（文档 userName，代码 username） POST /user/update | mobile | string | string | 否 | 是 | 必填不一致 POST /user/update | email | string | 未出现 | 否 | 否 | 缺失（代码未传） POST /user/update | profile.avatar | string | profile.avatarUrl | 否 | 否 | 嵌套层级差异＋命名不一致 GET /user/list | pageSize | number | number | 是 | 是 | 一致 GET /user/list | list[].id | number | string | 是 | 是 | 类型不符 三、不一致项清单 1. GET /user/detail 的 userId：文档为 string，代码按 number 传，需确认后端接收类型。 2. GET /user/detail 的 userName：文档 userName，代码 username，建议统一为文档写法。 3. POST /user/update 的 mobile：文档非必填，代码设为必传，请确认是否应改文档。 4. POST /user/update 的 email：文档有、代码未传，确认是否仍需要该字段。 5. profile.avatar 与 profile.avatarUrl：层级和名称都不同，需对齐后改一边。 6. GET /user/list 的 list[].id：文档 number，代码按 string 处理，注意列表渲染和比较逻辑。 四、待人工确认 以上结论由工程师持证/负责人员核对后才能用于联调和发布；哪边为准需与后端确认。