先确认出问题的入口
先记下是在多语言设置框点击「自动翻译」，在文章编辑页执行单篇翻译，还是在内容列表运行「AI 批量处理 → 批量翻译」。这三种操作读取的内容和处理字段不同。
排查前保留具体错误提示、发生时间、源文章与目标文章 ID、语言及任务设置。如果提示无权限，先确认账号权限；后台单篇翻译接口要求管理站点设置的权限（manage_options），不能只凭能够编辑文章就判断可以调用。
按现象检查
| 现象 | 检查与处理 |
|---|---|
| 设置字段自动填充没有使用 AI | 该入口使用「翻译厂家」。文章 AI 翻译开关不会改变它使用的服务。 |
| 已开启文章 AI 翻译，但没有按预期使用 AI | 检查当前 AI 通道的密钥、地址和模型。开关开启且三项齐全，文章翻译才会选择 AI。 |
| 翻译出来的是旧正文 | 确认使用了哪个入口，以及源文章是否保存。批量处理读取已保存的源文，不会读取另一个编辑窗口中未保存的修改。 |
| 下载资源名称仍是源语言 | 检查批量任务是否勾选「_guaqi_metas」。只翻译正文不会自动处理所有附加设置。 |
| 商品属性、规格或交付说明未翻译 | 当前商品批量翻译提供「商品属性、规格及交付说明」，且默认勾选。核对本次任务是否选择该项、任务是否成功，以及目标商品的实际字段内容。 |
| 分类名称带语言后缀 | 可能是复制流程补建的分类。打开目标语言分类，检查名称、SEO 和父级，不要只重试文章正文。 |
| 翻译后前台无法访问或返回 404 | 打开目标文章，检查是否仍为草稿，再核对目标语言、分类范围和实际访问的文章 ID。 |
| 失败后重试，却显示跳过 | 上次可能已经复制出目标草稿。检查该目标，再决定是否将已有译文策略改为覆盖。 |
确认单篇翻译用了哪份内容
单篇编辑页面会尝试读取编辑器中的标题和正文，并收集支持的附加设置，例如导航和商品数据。因此，单篇翻译不能简单理解为只读取数据库中的旧文章。
排查时先保存当前内容，再执行一次翻译，更容易确认来源。检查时同时对照源文章、目标文章和当前编辑语言，避免打开了另一份语言记录。
批量翻译则先复制已保存的源文章，再翻译所选字段。覆盖模式下，只选标题仍可能替换目标正文；字段勾选限制的是翻译范围，不是复制范围。
处理服务报错
- 认证失败：核对当前服务使用的密钥、地址及所需区域等参数。
- 额度或频率限制：检查对应服务账号的额度和调用限制，处理后再试。
- 语言不支持：核对所选目标语言是否被当前服务支持。
- 超时：检查 WordPress 所在服务器、网络代理和上游服务响应。长内容处理可能耗时较久，不要连续重复点击。
文章翻译选用 AI 后，调用失败默认直接报错，不会自动改用普通翻译厂家。应先根据具体提示处理当前通道的问题。
处理部分字段未翻译
先打开任务设置，确认该字段是否被选中，再检查目标中是否有实际内容。摘要尤其需要注意：复制没有直接带入源摘要，因此即使勾选摘要翻译，也要核对翻译的究竟是哪份摘要。
导航副标题等附加字段不能按正文的结果判断。单篇编辑页会收集导航附加数据，批量任务则按自己的字段范围处理。若对应字段仍未翻译，可在目标文章中手动填写，或使用适用的单篇操作后复核。
重新验证结果
- 打开目标文章，确认标题、正文和需要处理的附加字段已经正确保存。
- 核对语言关联、分类及发布状态，检查复制带入的价格、资源地址和权限。
- 通过目标网站的语言入口访问译文，确认实际页面显示正常。
- 批量任务还要查看失败和跳过记录，不能只看“处理完成”提示。
仍无法定位时，可按反馈清单提供操作入口、错误提示、发生时间、相关文章 ID 和本次任务设置。