常见报错

配图占位 · 待补

一条报错的四层定位

一张真实报错原文截图，旁边用 WordPress / GSC / GA4 / AI 四层标签标出「先查哪一层」。

• 保留完整错误原文
• 四层标签指向对应配置
• 不要出现密码、Token 或客户数据

建议文件：docs-troubleshooting-01.webp

排查顺序

WordPress 接入

报错 / 现象	多半原因	下一步
HTTP 401 / HTTP 403	用户名填成了应用密码名称；密码失效；账号权限不足；站点没启用 HTTPS	核对用户名；重新生成应用密码；确认账号能编辑内容
HTTP 404	插件没装 / 没启用；接入地址写错；固定链接是「朴素」	启用插件；核对 https://域名；改固定链接
HTTP 429	之前失败次数太多，端点暂时锁定	等锁定过期，不要连续重试
SSL connection timeout / Connection reset	主机防火墙、WAF、跨境链路抖动	先重试一次；持续失败联系主机放行
schema 不在支持范围	插件版本比工作台新或旧	升级插件或工作台，不要硬读
端点返回的不是 JSON	安全插件 / 主题在 REST 响应里输出了 HTML	关掉该插件的 REST 拦截，或联系服务人员
工作台能连上，但页面数是 0	站点没有已发布内容；或采集范围配置错	先在 WordPress 里确认有已发布页面

GSC

报错 / 现象	多半原因	下一步
没有权限 / PERMISSION_DENIED	服务账号没加、加错属性、邮箱复制错	重新核对用户和权限
数据全是 0	属性对但站点确实没曝光；或刚加还没生效	等几分钟到一天，用 GSC 原生界面核对
数据日期停在几天前	GSC 本身延迟 2–3 天	正常，不要反复同步
关键词数比 GSC 界面少	工作台过滤了 site: 等搜索运算符	口径差异，不是丢数据
收录数显示「未导入」	还没上传 GSC 覆盖数据	从 GSC 导出后导入，或先看有曝光页

GA4

报错 / 现象	多半原因	下一步
PERMISSION_DENIED	服务账号没加、加错媒体资源	回到媒体资源访问管理核对
analyticsdata.googleapis.com	平台侧 Analytics Data API 没启用	联系服务人员，不需要你开 GCP
媒体资源 ID 无效	填了 G- 开头的衡量 ID	改成纯数字 Property ID
转化列是「—」	没标记转化事件	在 GA4 里标记，并填事件名
数据为空	流量极低，或 GA4 埋点没装	先在 GA4 实时报告确认有数据

AI 与回写

报错 / 现象	多半原因	下一步
「未接入 AI」/ 按钮点不动	这一站没填 API Key，或平台侧未就绪	去 AI设置 → API设置 填钥匙
生成很慢 / 超时	模型排队、正文太长、网络抖动	稍后重试；一次只生成一页
「这个站正在跑别的任务」	采集或回写占着站点锁	等当前任务结束，不要重复点
「原文在正文里找不到了」	生成建议后页面又被改过	重新生成一版再采纳
「没开启正文回写」	站点配置关闭了 link_apply	联系服务人员确认是否允许改正文
采纳成功但页面没变	缓存 / CDN / 页面未复采	清缓存，点「同步本页」再确认
写回后读回值不一致	主题或插件在输出时改了字段	检查是否有其它 SEO 插件覆盖

仍然不通时，提供这些信息

不要发完整密码。把下面这些发给服务人员，能省很多来回：

• 站点地址、发生时间；
• 工作台显示的完整错误原文（截图或复制文字）；
• 插件版本、WordPress 版本、PHP 版本；
• 是「测试连接」「同步」「生成」还是「采纳」哪一步失败；
• 最近有没有换主题、装安全插件、改固定链接、迁服务器。