常见问题
同步时卡住不动
- 在 Github 自动化流程中同步卡住
- 本地同步运行时卡住
- 图片下载时卡住
- 文档下载时卡住
解决办法
在全量同步时,因为语雀/FlowUs 为国内平台,有时会在 Github 等国外环境运行时由于网络问卡住。此时可以在本地先手动运行一遍,提交缓存文件到 Github,后续的增量同步会快很多。相反用 Notion 在本地进行同步时,也有同样的问题,放在 Github 同步就会快很多。
还有一种可能是由于需要同步的文档中的新图片数量太多,所以每次都是新增上传图片到 CDN,会导致整体的流程变慢甚至失败。因为 Elog 会检测图片在 CDN 是否已经上传过,可以多试几次。
由于 Notion 的 API 在大部分情况下都很慢,甚至会下载文档失败。这是官方的问题,可以选择降低 Notion 下载文档时的并发数(默认为 3)。在 Elog 配置文件中设置write.notion.limit=1
,降低文档下载并发数,也可多试几次。
同步时报超时错误
- 下载文档超时
- 下载图片超时
解决办法
默认超时时间为 60s,如果经常超时,可配置环境变量p
,增加请求超时时间。
本地同步时,在.elog.env 文件新增REQUEST_TIMEOUT=900000
,设置更大的超时时间
在 CI/CD 中,可在自动化平台注入同样的环境变量即可
或者多试几次,总有一次成功!