故障排除
故障排除问题排查

问题排查

翻译失败可能有多种原因,主要包括:

  • 翻译 API 离线
  • 所选翻译提供商的 API 密钥未配置
  • 未启用自动翻译,因此翻译文章未被创建
  • 其他原因

以下介绍如何找出问题所在。

翻译失败时接收通知

默认情况下,每当 🔴 Error 条目被添加到日志时,插件菜单中会显示一个通知徽章

「Hello World」文章的西班牙语翻译失败,通知徽章已显示
「Hello World」文章的西班牙语翻译失败,通知徽章已显示

这将告知我们某次翻译已失败,并提示我们查看日志。

定位问题

查看日志。如果发现 🔴 Error,那肯定就是问题所在。

如果发现 🟡 Warning,则表示 query 遇到了意外情况,这可能是问题的根源。

例如,如果翻译后的文章未被分配标签,原因是这些标签事先未被翻译;此时日志中会包含一条警告条目:Tag has no translation for language '...'

在此截图中,一条包含 🔴 Error 的日志条目帮助我们了解媒体项翻译为何未成功:

查看单条日志
查看单条日志

该日志条目内容如下:

🔴 Error [Query "translate-media"] Execution with errors: Provider 'DeepL' doesn't have an API key configured

问题在于插件设置页面中未配置 DeepL 的 API 密钥。