> For AI agents: the complete documentation index is available at https://www.notionhub.app/llms.txt, the full documentation bundle is available at https://www.notionhub.app/llms-full.txt.

# 运行状态与排错

点击「开始同步」后，插件会显示当前任务状态。大多数问题可以先根据状态和提示文案判断。

## 常见状态

| 状态        | 含义              | 建议               |
| --------- | --------------- | ---------------- |
| 正在同步      | 任务已经开始运行        | 等待任务完成，不要重复点击    |
| 同步成功      | 本次任务正常结束        | 打开 Notion 模板查看数据 |
| 同步失败      | 任务运行中出现阻塞错误     | 查看错误提示并按本文排查     |
| 已取消       | 新任务取消了旧任务，或运行超时 | 如果不是你主动重试，请联系支持  |
| 免费体验次数已用完 | 当前服务的免费同步次数已经用完 | 购买激活码后重新运行       |

Telegram 和长毛象由 Worker 托管，不会生成 GitHub Action 链接。它们仍使用相同的正在同步、成功、失败和额度状态，直接以插件内运行记录为准。

## 同步成功但 Notion 没有数据

可能原因：

- 第一次同步数据较多，Notion 页面还没有刷新。
- 第三方平台本身没有可同步的新数据。
- 模板没有完整授权给 NotionHub。
- 你打开的不是刚才授权的模板页面。
- 某些子模块在同步设置中没有开启。

建议先刷新 Notion 页面，再打开插件查看最近一次运行时间。如果超过 5 分钟仍没有数据，请检查模板授权。

## 一直显示正在同步

如果 GitHub Action 已经成功结束，但插件仍显示正在同步，通常是运行状态缓存没有及时刷新。

可以尝试：

1. 关闭插件弹窗后重新打开。
2. 刷新浏览器页面。
3. 等待 1 分钟后再查看。

如果多次刷新后仍不更新，请联系技术支持，并提供服务名和 GitHub Action 链接。

## 提示登录过期

这说明第三方平台的 Cookie、Token 或授权已经失效。

处理方式：

- 微信读书：重新扫码登录。
- 小宇宙：从插件重新打开小宇宙官方账号页登录。
- Flomo、B 站、多邻国：重新打开对应网页完成登录，再回插件更新登录状态。
- Toggl：检查 API Token 是否被重置。
- Spotify：在 Spotify 网页版确认登录，再回插件重新连接，参见 [Spotify 使用指南](https://www.notionhub.app/docs/spotify.md)。
- Strava、Trakt、YouTube 等 OAuth 服务：重新授权。
- 长毛象：确认实例仍可访问，并从插件在同一实例重新授权。

重新登录后，再点击「开始同步」。

## 提示模板不存在或无访问权限

常见原因是 Notion 模板被删除、移动后权限丢失，或授权时选错页面。

请参考 [模板页面不存在或无访问权限](https://www.notionhub.app/docs/template-page-no-access.md)。

## 提示 404

如果 Notion 授权回调或模板页面打开后提示 404，请参考 [修复 404 问题](https://www.notionhub.app/docs/fix-404.md)。

## 提示免费体验次数已用完

免费体验次数用完后，需要购买激活码继续使用。

购买说明见 [获取激活码](https://www.notionhub.app/docs/get-activation-code.md)。

## 任务被取消

常见情况：

- 你重复点击了「开始同步」，新任务取消了旧任务。
- GitHub Action 达到最长运行时间限制。
- GitHub 仓库或 Action 权限发生变化。

如果是重复点击导致的取消，可以忽略旧任务，只看最新任务结果。

如果任务经常因为超时被取消，通常说明当前服务数据量较大，或者开启了较多媒体上传。可以先关闭大文件上传，再重新运行。

## 媒体上传失败

图片、音频、视频上传失败不一定代表主数据同步失败。

常见原因：

- Notion 免费版单个文件大小限制。
- 第三方平台限制下载。
- GitHub Action 网络较慢。
- 上传过程中临时超时。

如果 Notion 中已有文字数据，可以先正常使用，之后再重新运行补充媒体。

更多说明见 [图片、音频和视频上传](https://www.notionhub.app/docs/media-upload.md)。

## 联系支持时需要提供什么

为了更快定位问题，请尽量提供：

- 同步服务名称。
- 插件里看到的错误文案。
- 最近一次运行时间。
- 如果绑定了 GitHub，提供 GitHub Action 链接。
- 不要发送 Cookie、Token、验证码、Notion access token 或完整激活码。

联系方式见 [技术支持](https://www.notionhub.app/docs/support.md)。
