专题归档 · 2025 年 9 月(编辑分组,非实际写作日期)
实习排障:新分页接口明明接了参数,为什么还返回全量数据?
前端列表已接入分页参数,为什么接口仍返回全量数据?
从旧接口换到新接口
原始任务是给管理端职位列表增加字段、调整展示方式。旧接口只需要公司标识,新接口表面上要求分页参数,于是页面也按分页方案准备改造。
但旧笔记中先记录“原本的 API 只需要传入一个 compId”,后面又发现无论传入什么分页参数,接口仍返回全部数据。这是一处实际的前后端契约不一致,而不是前端表格是否漂亮的问题。
不先相信接口参数的名字
这份经历提醒:有 pageNo 和 pageSize 字段,不等于后端真的执行了分页;最好把请求、响应条数、总数字段和列表渲染方式一起验收,再决定使用前端分页还是服务端分页。
这次联调的关键是厘清分页接口、前端列表状态与筛选条件之间的契约。具体的业务数据并不影响这一判断,更值得核对的是返回结构与请求参数是否一致。
这是一份当时接口行为的记录,不保证今天系统仍然如此。