本指南旨在为管理员提供一套标准的排障流程，用于解决在配置或使用“飞书数据源同步”功能时遇到的各类问题，如人员/部门同步失败、信息不完整或实时更新失效等。

请先阅读数据源同步常见问题，确认您遇到的问题是否已有对应的快速解决方案。若上述文档未能解决您的问题，请遵循本文提供的排查步骤进行深度诊断。

步骤一：飞连后台配置核对

首先，请仔细核对您在飞连管理后台的数据源配置，确保与您的飞书应用信息完全一致。

1. 登录飞连管理后台，导航至身份 ＞ 账号配置 ＞ 数据源同步。
2. 找到并进入您的“飞书数据源”配置页面。
3. 重点核对以下信息：
   • App ID / App Secret：​确保与您在飞书开放平台创建的应用凭证完全一致。
   • Encrypt Key / Verification Token：​（适用于实时同步）确保与飞书开放平台事件与回调 ＞ 加密策略中配置的密钥和令牌一致。
     
     

步骤二：飞书开放平台应用权限核对

核对应用权限范围

1. 在应用详情页，进入权限管理页面。
2. 确保您的应用已申请并获得了足够的 API 权限。您可以点击批量导入/导出权限，将以下 JSON 内容粘贴进去，系统将自动勾选飞连数据源同步所需的最小权限集合。

   说明

   部分旧版本中推荐的权限可能在新版飞书中已无法开通，可忽略。

   {
     "scopes": {
       "tenant": [
         "admin:admin_dept_stat:readonly",
         "admin:admin_user_stat:readonly",
         "admin:app.user_usable:readonly",
         "application:application.contacts_range:write",
         "contact:contact",
         "contact:contact.base:readonly",
         "contact:department.base:readonly",
         "contact:department.organize:readonly",
         "contact:group:readonly",
         "contact:role:readonly",
         "contact:user.base:readonly",
         "contact:user.department:readonly",
         "contact:user.email:readonly",
         "contact:user.employee:readonly",
         "contact:user.employee_id:readonly",
         "contact:user.gender:readonly",
         "contact:user.id:readonly",
         "contact:user.phone:readonly",
         "corehr:authorization:read",
         "corehr:department.cost_center_id:read",
         "corehr:department.custom_fields:read",
         "corehr:department.manager:read",
         "corehr:department.operation_log:read",
         "corehr:department.organize:read",
         "corehr:department:read",
         "corehr:security_group:read",
         "directory:department.idconvert:read",
         "directory:department:list",
         "directory:department:read",
         "directory:employee.work.staff_status:read",
         "directory:employee:read",
         "passport:session_mask:readonly"
       ],
       "user": [
         "contact:user:search"
       ]
     }
   }
   

核对应用可见范围

如果出现部分员工或部门无法同步的情况，可能是由于应用对他们不可见。

1. 在应用详情页，进入版本管理与发布。
2. 检查应用的“可用范围”设置。请确保所有需要被同步到飞连的部门和员工，都包含在可用人员范围之内。
   

步骤三：核对飞书开放平台事件订阅（针对实时同步）

如果您发现实时同步（例如，飞书上员工入职后，飞连没有立即同步）失效，请重点检查您在飞书后台订阅了哪些事件，确保您已添加了所有必要的通讯录变更事件。实时同步依赖于这些事件的触发。

• 飞连认证渠道工程师：请通过飞书搜索飞连 FOC，提交工单处理。
• 企业用户：请通过火山引擎官网提交工单处理。