TYPO3 11.5.25 XML站点地图不显示页面问题求助

• 页面SEO属性排查
  直接检查需要收录的页面属性里的SEO标签：

  • 不要勾选「排除在站点地图之外」，这个选项会直接将页面从地图中移除
  • 页面状态必须为已发布，草稿、隐藏状态的页面不会被收录

• 多域名根页面绑定验证
  每个域名对应的根页面，必须在站点配置中正确绑定域名，且根页面的「站点」字段已关联到对应站点配置。若域名与根页面未绑定，TYPO3无法匹配到对应站点的页面，会返回空索引

• TypoScript配置检查

  • 确认模板已添加「SEO (seo)」静态模板，未引入该模板的话SEO扩展的站点地图逻辑不会生效
  • 排查自定义TypoScript是否破坏了页面收集逻辑：比如误设置plugin.tx_seo.sitemap.pages.config.excludeDoktypes排除所有页面类型，或includePages未设置有效页面范围
  • 全局配置中不要开启config.no_search或config.excludeFromXmlSitemap，这两个参数会全局屏蔽所有页面

• 缓存与请求上下文验证

  • 清除所有缓存（包括页面缓存、配置缓存），多域名站点需注意清除对应站点的缓存，旧缓存会导致新配置不生效
  • 访问站点地图时必须使用站点配置中绑定的域名，不要用IP或未绑定的域名，TYPO3按请求域名匹配站点，域名不匹配会无法找到对应页面
  • 确保以匿名用户身份访问，若用后端用户登录访问，可能因权限限制看不到部分页面

• 调试模式定位原因
  临时开启调试模式：在LocalConfiguration.php中添加$GLOBALS['TYPO3_CONF_VARS']['BE']['debug'] = true;，访问站点地图后查看源代码中的调试注释，里面会明确标注页面被排除的原因。也可直接在后端「SEO > 站点地图」模块查看预览，确认是否有页面显示

内容的提问来源于stack exchange，提问作者Giovanni Romero Pérez