troubleshooting
本地来源：seo-llm/skill/google-seo-skill/references/troubleshooting.md
SEO 常见问题排查
1. 索引问题
页面未被索引
diagnosis:
step_1: "使用 Google Search Console URL 检查工具"
step_2: "检查页面是否可正常访问（HTTP 200）"
step_3: "检查 robots.txt 是否阻止抓取"
step_4: "检查页面是否有 noindex 标签"
step_5: "检查 canonical URL 是否正确"
common_causes:
noindex_tag:
check: "查看 <meta name='robots' content='noindex'>"
fix: "移除 noindex 或改为 index"
robots_blocked:
check: "测试 robots.txt 是否阻止该路径"
fix: "更新 robots.txt 允许抓取"
canonical_mismatch:
check: "canonical URL 是否指向其他页面"
fix: "设置 canonical 指向自身"
low_quality:
check: "页面内容是否过少或重复"
fix: "增加高质量原创内容"
orphan_page:
check: "是否有内链指向该页面"
fix: "添加内部链接"
new_page:
check: "页面是否刚创建"
fix: "提交 sitemap 或请求索引"
索引波动
fluctuation_causes:
- "Google 算法更新"
- "内容质量变化"
- "服务器不稳定导致抓取失败"
- "大量页面被重定向或删除"
monitoring:
- "定期检查 Search Console 索引覆盖率"
- "设置警报监控索引页面数量变化"
- "记录重大更改的时间线"
2. 性能问题
Core Web Vitals 不达标
lcp_too_slow:
target: "< 2.5s"
common_causes:
- cause: "图片未优化"
fix: "使用 WebP/AVIF 格式，启用 lazy loading"
- cause: "未使用 CDN"
fix: "配置 CDN 分发静态资源"
- cause: "服务端渲染太慢"
fix: "使用 SSG/ISR 替代 SSR"
- cause: "关键资源未预加载"
fix: "添加 <link rel='preload'>"
- cause: "大量 render-blocking 资源"
fix: "内联关键 CSS，异步加载非关键 CSS/JS"
inp_too_slow:
target: "< 200ms"
common_causes:
- cause: "JavaScript Long Tasks"
fix: "分割大任务，使用 requestIdleCallback"
- cause: "事件处理器中有重计算"
fix: "使用 Web Worker 或 debounce"
- cause: "第三方脚本阻塞"
fix: "使用 async/defer 加载"
cls_too_high:
target: "< 0.1"
common_causes:
- cause: "图片/视频无尺寸"
fix: "设置 width 和 height 属性"
- cause: "动态注入内容"
fix: "预留空间（min-height）"
- cause: "自定义字体闪烁"
fix: "使用 font-display: swap + 预加载"
- cause: "广告位未固定尺寸"
fix: "为广告容器设置固定高度"
3. 结构化数据问题
structured_data_errors:
missing_required_fields:
diagnosis: "Search Console 报告缺少必填字段"
fix: "根据 schema.org 规范补充所有必填字段"
invalid_format:
diagnosis: "JSON-LD 语法错误"
fix: "使用 Google Rich Results Test 验证 JSON 格式"
not_detected:
diagnosis: "结构化数据未被 Google 识别"
causes:
- "JSON-LD 在客户端渲染（useEffect 注入）"
- "JSON-LD 被 JavaScript 错误阻止"
- "嵌套结构不正确"
fix: "确保 JSON-LD 在服务端渲染的 HTML 中"
faq_duplicate:
diagnosis: "FAQ Schema 跨页面重复"
check: "搜索项目中所有 FAQPage Schema 的 question 字段"
fix: "确保每个 FAQ 问题只出现在一个页面的 Schema 中"
validation_tools:
- "Google Rich Results Test: https://search.google.com/test/rich-results"
- "Schema Markup Validator: https://validator.schema.org/"
- "Google Search Console → 增强功能"
4. 爬取问题
crawl_issues:
crawl_budget_waste:
symptoms: "重要页面未被抓取，但大量低价值页面被抓取"
fixes:
- "robots.txt 阻止低价值路径（如搜索结果页、过滤页）"
- "对低价值页面使用 noindex"
- "减少参数化 URL（使用 canonical）"
- "修复重定向链（不超过 2 跳）"
crawl_errors:
5xx:
cause: "服务器错误"
fix: "检查服务器日志，修复应用错误"
4xx:
cause: "页面不存在"
fix: "设置自定义 404 页面，添加重定向或移除失效链接"
timeout:
cause: "页面加载超时"
fix: "优化服务器响应时间，检查是否有死循环"
redirect_issues:
chains: "重定向链应 ≤ 2 跳"
loops: "检查是否有重定向环路"
mixed: "确保 HTTP → HTTPS 重定向正确"
5. 移动端问题
mobile_issues:
viewport_not_set:
check: "是否有 <meta name='viewport'>"
fix: '<meta name="viewport" content="width=device-width, initial-scale=1.0" />'
content_wider_than_screen:
check: "是否有水平滚动条"
fix: "检查固定宽度元素，使用 max-width: 100%"
text_too_small:
check: "正文字体是否 < 16px"
fix: "设置移动端基础字体 ≥ 16px"
touch_targets_too_close:
check: "可点击区域是否 < 48x48px"
fix: "增大按钮/链接的点击区域和间距"
interstitials:
check: "是否有全屏弹窗阻挡内容"
fix: "移除或缩小侵入式弹窗"
6. 排名下降排查
ranking_drop_diagnosis:
step_1:
action: "确认下降范围"
questions:
- "是所有页面还是特定页面？"
- "是所有关键词还是特定关键词？"
- "是所有设备还是特定设备？"
step_2:
action: "检查时间线"
correlate_with:
- "Google 算法更新时间"
- "网站重大更改（迁移、重新设计）"
- "技术问题（服务器宕机）"
- "内容更改或删除"
step_3:
action: "技术检查"
items:
- "Search Console 是否有手动操作通知"
- "robots.txt 是否意外更改"
- "是否有新的 noindex 标签"
- "服务器是否稳定（检查 uptime）"
- "SSL 证书是否过期"
step_4:
action: "内容检查"
items:
- "内容是否过时"
- "竞争对手是否发布了更好的内容"
- "是否存在关键词蚕食"
- "E-E-A-T 信号是否下降"
step_5:
action: "外部因素"
items:
- "是否有负面 SEO 攻击（垃圾外链）"
- "行业搜索趋势是否变化"
- "Google SERP 布局是否变化"
7. 快速诊断命令
使用 Google PageSpeed Insights 在线检测：https://pagespeed.web.dev/
manual_checks:
site_search:
command: "在 Google 搜索 site:yourdomain.com"
purpose: "查看已索引的页面数量"
cache_check:
command: "在 Google 搜索 cache:yourdomain.com/page"
purpose: "查看 Google 缓存的页面版本"
robots_test:
url: "https://www.google.com/webmasters/tools/robots-testing-tool"
purpose: "测试 robots.txt 规则"
rich_results_test:
url: "https://search.google.com/test/rich-results"
purpose: "测试结构化数据"
mobile_friendly_test:
url: "https://search.google.com/test/mobile-friendly"
purpose: "测试移动端友好性"
8. Google 官方澄清的 SEO 迷思
seo_myths_debunked:
- myth: "meta keywords 标签影响排名"
truth: "Google 从 2009 年起就不使用 meta keywords，完全忽略此标签"
- myth: "域名年龄越长排名越高"
truth: "域名年龄不是排名因素，新域名同样可以获得好排名"
- myth: "Google Ads 投放能提升自然搜索排名"
truth: "付费广告和自然搜索完全独立，互不影响"
- myth: "跳出率是排名因素"
truth: "Google 不使用 Google Analytics 数据作为排名信号"
- myth: "必须定期提交 sitemap 才能被索引"
truth: "Sitemap 是提示，Google 主要通过链接发现页面。但 sitemap 有助于大型站点"
- myth: "HTTPS 是重要的排名因素"
truth: "HTTPS 是轻微的排名信号（tiebreaker），主要作用是用户信任和安全"
- myth: "字数越多排名越好"
truth: "Google 不按字数排名，优先考虑内容质量和相关性"
9. 已废弃/停用功能
deprecated_features:
- feature: "rel='prev/next' 分页标签"
deprecated_since: "2019"
note: "Google 从未将其作为索引信号，分页页面各自 canonical 指向自身即可"
- feature: "Sitelinks Search Box (SearchAction in WebSite Schema)"
deprecated_since: "2024.11"
note: "Google 不再支持通过结构化数据触发站内搜索框"
- feature: "Search Console URL Parameters 工具"
deprecated_since: "2022.04"
note: "改用 canonical 标签和 robots.txt 处理参数化 URL"
- feature: "FAQ Rich Results（普通网站）"
restricted_since: "2023"
note: "FAQ 富媒体结果现仅限健康类权威网站和政府网站展示"
- feature: "Crawl-delay robots.txt 指令（对 Google）"
note: "Google 从未支持此指令，仅 Bing/Yandex 等支持"
- feature: "Google Cache 页面查看"
deprecated_since: "2024"
note: "cache: 搜索运算符已停用，改用 URL Inspection 工具"
相关文档
- Google Search Console — 索引诊断与问题报告
- 技术 SEO — 爬虫控制与索引优化
- JavaScript SEO — JS 渲染问题排查
- 部署后 SEO 检查 — 上线后检查清单
- 性能优化与 Core Web Vitals — 性能问题诊断
本文档为站内渲染。原始文件本地路径：saas/source/seo-llm/skill-google-seo-skill-references-troubleshooting-d2b251.md（仅本地保留，不入库不部署）