故障排查

飞书同步失败排查

配置飞书后同步总是失败的三步排查路径

请按以下顺序逐项检查:

1. 检查应用权限

在飞书开放平台为该自建应用开通:

  • 多维表格 读写权限
  • 必要的 通讯录 等辅助查询权限(按扩展当前版本要求配置)

2. 核对凭证与发布状态

  • 确认 App ID、App Secret 填写正确,无多余空格。
  • 确认应用已在飞书后台正式发布版本并上线,未发布版本无法调用生产 API。

3. 查看后台日志

若表格与字段映射配置无误,可在 chrome://extensions 中点击扩展 Service Worker 的 Inspect,查看后台具体错误返回,定位字段映射或权限问题。

延伸阅读