连接器Notion
常见问题
排查 Notion OAuth、访问令牌、页面授权、数据库层级和资源库同步问题。
建议按应用安装 → 连接验证 → Notion 页面权限 → 数据源绑定 → 同步与预览的顺序排查。先区分当前使用 OAuth、内部连接令牌还是个人访问令牌。
连接与授权问题
| 现象 | 检查与处理 |
|---|---|
| 没有 Notion 应用或无法连接 | 确认目标工作空间已安装并启用 Notion，授权方式由当前环境提供 |
| OAuth 没有可用客户端 | 由管理员在“自带授权应用”中登记有效凭证，或确认平台默认客户端是否可用 |
| 找不到自带授权应用页签 | 此入口需要 EasyXAI 工作空间管理权限 |
| 重定向地址错误 | 核对 Notion Redirect URIs 与当前部署的完整回调地址；添加后确认已保存 |
| 登记了 OAuth 应用却没有账号 | 成员仍需从“连接账号”发起授权并完成回跳 |
| 授权页无法选择目标工作空间 | 检查登录账号、应用安装范围和 Notion 工作空间的连接管理策略 |
| 权限范围不知道怎么填 | Notion OAuth 在 EasyXAI 中留空，读取能力在 Notion 后台配置 |
| 第三方未返回长期授权 | 检查当前 Notion OAuth 客户端及平台配置；不要添加飞书的 offline_access 权限 |
| 访问令牌验证失败 | 检查令牌有效期、工作空间策略和类型；OAuth client secret 不能作为访问令牌 |
| 提示拿不到账号信息 | 请管理员检查当前环境的 Notion 身份识别配置；记录时间和错误提示，不提供真实密钥 |
| 内部连接未显示个人姓名 | 内部令牌代表连接机器人，可通过备注辨认，不意味着变成了个人授权 |
为什么能在 Notion 打开页面，EasyXAI 却看不到
| 连接类型 | 重点检查 |
|---|---|
| OAuth | 页面是否在授权选择中；你能阅读该页，不代表有权将它分享给连接 |
| 内部连接 | 页面或父页面是否已添加正确的 Connection，连接是否有读取能力 |
| 个人令牌 | 令牌所属工作空间是否正确，创建者当前是否仍有页面访问权限 |
不需要将页面发布到互联网。先授权所需页面，再尝试浏览；新授权内容可能受 Notion 搜索索引延迟影响，根列表也不是全工作空间内容的完整清单。
OAuth 能力发生变化后，成员需要重新授权。内部连接则要检查能力设置和页面共享；反复新建 EasyXAI 数据源不会自动扩大 Notion 权限。
资源库问题
| 现象 | 检查与处理 |
|---|---|
| 找不到创建入口 | 进入目标资源库，点击“导入 → 外部数据源” |
| 创建按钮不可用 | 检查名称、数据来源、有效连接及目标资源库的编辑权限 |
| 没有 Wiki／Drive 选项 | Notion 无需配置这些飞书专用选项 |
| 无法使用工作空间共享 | 当前界面要求工作空间管理员操作，并具备目标位置的管理权限 |
| 数据源待连接 | 绑定当前工作空间的有效连接；独立模式下每位成员分别绑定 |
| 能查看目录，但绑定自己的账号被拒绝 | 独立模式首次绑定或换绑也需要数据源编辑权限；请管理员确认权限，只有查看权限不够 |
| 刚授权的页面未出现 | 检查授权范围，稍后重新打开远端浏览列表 |
| 数据库展开后还有一层 | Notion 数据库可能包含多个 data source，继续展开相应数据集合 |
| 数据库条目预览缺少表格属性 | 预览读取页面文本正文，不复制完整属性表、公式或视图 |
| 父页面预览没有子页面正文 | 子页面需从目录中单独打开 |
| 图片、嵌入块或长页面展示不全 | 预览只包含支持的文本且有长度与嵌套限制，完整内容请打开原文 |
| 另一位成员看到目录却无法预览 | 目录信息共享，但独立模式下正文按其绑定连接读取；检查该连接的页面权限 |
| 同步持续等待或部分失败 | 检查连接、页面权限和 Notion 限流情况；恢复后重新提交失败的同步根 |
| 没选满 50 项却提示任务数量超限 | 选择上限是 50，但同一用户在当前工作空间最多有 10 个待处理或运行中的任务，请分批提交 |
| 提示节点数或深度限制 | 改选较小的页面树或数据库范围，不能仅反复提交同一个大目录 |
完整使用流程见资源库同步。
账号正常，为什么智能体仍不能使用 Notion
账号验证、数据源读取和智能体应用能力分别检查。请确认 Notion 的应用能力中已经提供并启用所需工具，运行账号有效，智能体配置中也添加了 Notion。
在应用详情保存账号后，还需返回“应用能力”，为每项 MCP 或技能选择账号并确认「绑定成功」。仅保存连接或绑定数据源，不会自动完成能力绑定。
重新授权后原数据源仍不可用
修复原 OAuth 连接时，应使用原来的 Notion 账号并确认工作空间。若实际身份变化，授权可能形成另一条连接，需要重新为数据源或应用能力选择账号。原客户端已归档时，也需要使用其他有效客户端重新连接，不能只重试原来的授权入口。参阅凭据更新说明。
官方托管 Notion MCP 需要其对应的授权流程，不能将资源库连接正常当成 MCP 可用的证明。若详情显示“还没有可用的能力”，请管理员确认平台配置。参阅在 EasyXAI 中使用。
删除数据源会影响 Notion 原文吗
不会。删除只清理 EasyXAI 中的数据源及同步资源，不删除 Notion 页面，也不自动撤销账号连接。同一连接可能仍被其他数据源使用。
同步完成也不会自动保存全文或建立向量索引，因此不能直接推断已经支持整库问答。