一个接口返回 200 表格却空白,我栽在 AjaxResult 和 TableDataInfo 的字段层级上

0 阅读1分钟

情景引入:页面空白,后端说没问题,我盯着网络面板无从下手

最近在维护一个后台管理项目,有一个列表页原先好好的,我接了一个新接口后表格始终渲染不出来。F12 看网络请求,状态码 200,响应体里也有数据,控制台也没抛错。后端同学看了说“我这边返回没问题啊,code 也是 200”。于是我开始怀疑前端拼接、Vue 响应式、表格组件,折腾了近一下午,最后才发现问题出在 JSON 字段层级上:这个接口返回的是分页结构,字段是顶层的 rows 和 total,而我代码里写的是 res.data.rows。这一个小小的 data 层,让我白忙了 3 个小时。

根因:两种后端封装返回的 JSON 形状不一样

这个项目后端是 Java,接口返回常有两种封装。

第一种是通用业务操作成功,用 AjaxResult.success(data):

{
  "code": 200,
  "msg": "操作成功",
  "data": { "id": 1, "name": "张三" }
}

前端取值自然就写 res.data。

第二种是分页查询,用 getDataTable(list) 或 TableDataInfo:

{
  "code": 200,
  "rows": [{ "id": 1, "name": "张三" }],
  "total": 10
}

它没有 data 这一层,rows 和 total 直接放在顶层。

问题就出在这:两种返回都长着 code: 200 的外衣,但内部结构完全不同。如果前端把分页接口当成 AjaxResult 那样去取 res.data.rows,那么 res.data 是 undefined,进一步取 rows 也不会报错,只会拿到 undefined,最终表格就安静地空白。

伪装:为什么这种 bug 特别难发现

首先,它不会红字报错。undefined.rows 并不会抛异常,而是返回 undefined,前端拿到 undefined 传给表格组件后,表格组件可能只是没数据,不报错。

其次,后端返回 200 太有迷惑性。我们习惯先看状态码,200 就认为接口没问题。但 200 只代表 HTTP 层成功,不代表业务数据结构符合预期。

最后,同一个项目里字段还不一样。有的分页字段叫 rows,有的项目里叫 list 或 records,有的接口把 total 放在 data 里,有的放在顶层。如果没有统一约束,每次接新接口都像开盲盒。

快速定位:先别急着改代码,用这几招确认结构

怀疑是字段层级问题时,可以快速验证。

在浏览器控制台打印接口响应对象:

console.log(Object.keys(res));
// 如果只看到 ['code','msg','data'],就是 AjaxResult 风格
// 如果看到 ['code','rows','total'],就是 TableDataInfo 风格

或者直接打印:

console.log(res.data, res.rows, res.total);

如果 res.data 是 undefined,而 res.rows 有值,就说明写错了。

还可以在后端快速定位:搜索控制器里的返回语句,看是 return AjaxResult.success(...) 还是 return getDataTable(...),这决定前端取值方式。建议前端在接接口时问清楚或看接口文档示例响应。

修复:写一个不依赖具体字段位置的兼容取值

不要写死 res.data.rows 或 res.data.total。可以封装一个统一的取值函数:

function getListData(res) {
  if (!res || res.code !== 200) {
    return { rows: [], total: 0 };
  }
  return {
    rows: res.rows || res.data || [],
    total: res.total || 0
  };
}

在业务代码里这样用:

const { rows, total } = getListData(res);
this.tableData = rows;
this.pagination.total = total;

这样不管后端返回的是 AjaxResult 还是 TableDataInfo,都能拿到数据。另外,条件判断里不要写 if (res.data && res.code === 200),因为分页接口没有 res.data,这个条件会直接 false,导致数据永远不渲染。应该改成 if (res && res.code === 200)。

同时建议后端团队尽量约定分页接口统一走 TableDataInfo,非分页接口走 AjaxResult,并且字段名固定为 rows/total,避免出现 list/records 混用。

验收铁律

❌ 这些写法不要再出现

  • 列表接口前端取值写死 res.data.rows,因为分页接口的 rows 在顶层。
  • 分页总数写成 res.data.total || 0,因为 total 不在 data 里面。
  • 判断渲染条件写成 if (res && res.code === 200 && res.data),分页接口没有 data 字段,永远不渲染。
  • 把不同项目的字段名 list、records 当成当前项目的 rows。
  • 看到 HTTP 200 就认为接口返回结构一定符合前端预期,不做结构校验。

✅ 推荐做法

  • 取值前先打印或查看 Object.keys(res),确认顶层字段。
  • 统一封装取值函数,使用 res.rows || res.data 兼容两种结构。
  • 条件判断只用 res && res.code === 200,不额外要求 res.data。
  • 后端分页统一返回 { code, rows, total },业务数据统一返回 { code, data }。
  • 接新接口时,先看响应示例再写前端,不凭经验猜测字段层级。

技术问题就是这样,看起来越简单的字段差异,越容易在联调时吞掉一下午。如果你也遇到过类似“后端返回 200 但前端没数据”的情况,可以聊聊你的项目里是怎么统一接口返回结构的。