Airtable API返回记录数量与UI、CSV导出数量不一致问题求助

排查与解决步骤 #

• 首先核对API密钥对应的账号权限
  Airtable支持行级权限配置，若你调用API使用的密钥所属用户，和你登录UI导出CSV的账号不是同一个，可能因为权限限制无法访问部分行记录。你可以用缺失记录的ID单独调用单条查询接口验证：

  base("Dishes").find("你找到的缺失记录ID", (err, record) => {
    console.log('单条查询结果', err, record)
  })
  

  如果返回404，即可确认是权限问题，更换为拥有全表访问权限的账号生成的API密钥即可。
• 替换分页逻辑，使用官方封装的all()方法
  你当前使用的eachPage手写逻辑可能存在隐藏的分页异常，官方SDK提供的all()方法已经自动处理了全量拉取的分页逻辑，优先使用该方法：

  const base = airtable.base(item.baseId);
  const tableRecords = await base("Dishes").select({}).all();
  console.log("全量记录数", tableRecords.length);
  

• 升级Airtable SDK到最新版本
  旧版本的Airtable JS SDK存在部分分页相关的已知bug，你可以更新到最新版后重试：

  npm install airtable@latest
  

• 手动指定分页参数避免默认配置异常
  你可以在select中手动指定pageSize为最大值100，避免SDK默认配置异常：

  base("Dishes").select({
    pageSize: 100
  })
  

• 排除异步逻辑干扰
  检查你代码中的tableRecords数组是否在其他异步逻辑中被修改，导致最终计数不准确。你可以在eachPage的回调中每次打印当前页的记录数，累加后核对总和是否和最终结果一致，定位是API没有返回对应记录，还是本地逻辑丢失了记录。

内容的提问来源于stack exchange，提问作者Vasiliy vvscode Vanchuk