Skip to content
On this page

常见问题

同步时卡住不动

  • 在 Github 自动化流程中同步卡住
  • 本地同步运行时卡住
  • 图片下载时卡住
  • 文档下载时卡住

解决办法

在全量同步时,因为语雀/FlowUs 为国内平台,有时会在 Github 等国外环境运行时由于网络问卡住。此时可以在本地先手动运行一遍,提交缓存文件到 Github,后续的增量同步会快很多。相反用 Notion 在本地进行同步时,也有同样的问题,放在 Github 同步就会快很多。

还有一种可能是由于需要同步的文档中的新图片数量太多,所以每次都是新增上传图片到 CDN,会导致整体的流程变慢甚至失败。因为 Elog 会检测图片在 CDN 是否已经上传过,可以多试几次。

由于 Notion 的 API 在大部分情况下都很慢,甚至会下载文档失败。这是官方的问题,可以选择降低 Notion 下载文档时的并发数(默认为 3)。在 Elog 配置文件中设置write.notion.limit=1,降低文档下载并发数,也可多试几次。

同步时报超时错误

  • 下载文档超时
  • 下载图片超时

解决办法

默认超时时间为 60s,如果经常超时,可配置环境变量process.env.REQUEST_TIMEOUT,增加请求超时时间。

本地同步时,在.elog.env 文件新增REQUEST_TIMEOUT=900000,设置更大的超时时间

在 CI/CD 中,可在自动化平台注入同样的环境变量即可

或者多试几次,总有一次成功!