故障排查
head 没有变化、规则未命中、hreflang 不正确、JSON-LD 校验失败等常见问题的定位方法。
head 没有变化
- 打开控制台 站点管理 → SDK 接入，确认 最近心跳 在 5 分钟内；没有心跳说明脚本未加载或公钥错误
- 浏览器开发者工具查看
GET /sdk/config是否 200；NOT_FOUND表示公钥不对，403表示当前域名不在 Origin 白名单 - 处于
fill模式时，页面已有的字段不会被覆盖；需要覆盖请改为replace
规则未命中
- 在 SEO 头部规则 → 预览 输入实际路径验证匹配
- 路径模式区分大小写；带语言前缀的站点请不要把前缀写进模式（SDK 会先剥离）
- 多条规则命中时取优先级最高的一条，检查优先级数值
hreflang 指向 404
某语言没有对应页面或翻译未完成。打开该语言的 自动翻译，或在站点语言里暂时停用该语言。
JSON-LD 校验失败
- 使用编辑器右侧的校验结果定位缺失属性
{cover}等变量为空时对应字段会被省略；若该字段必填，请在页面变量中提供datePublished必须是 ISO 8601，可用{publishedAt | date:ISO}
SPA 路由后标题没更新
确认 data-spa 未关闭；如果框架自行管理 document.title，把 SDK 改为 replace 模式，或在路由完成后调用 geo.page()。
事件没有统计
事件上报走 sendBeacon，被浏览器扩展拦截时会静默失败；这不影响 head 更新。统计口径为聚合计数，不是实时数据。
获取帮助
把 SDK 接入 → 调试信息 中的站点公钥、SDK 版本与最近错误一并发给支持团队。