TYPO3 12.4.13 indexed_search缺失Extbase参数致详情页链接失效求助

1. 配置路由增强（Route Enhancers） #

这是最推荐的方案，既能生成友好URL，也能让indexed_search正确识别Extbase参数。在站点的config.yaml中添加对应扩展的路由增强配置：

routeEnhancers:
  TestShowEnhancer:
    type: Extbase
    extension: Test
    plugin: Show
    routes:
      - routePath: '/detail/{test_uid}'
        _controller: 'Test::show'
        _arguments:
          test_uid: uid
    defaultController: 'Test::show'
    aspects:
      test_uid:
        type: PersistedAliasMapper
        tableName: tx_test_domain_model_test
        routeFieldName: uid

配置生效后，详情页会生成domain.com/detail/137166这类友好URL，indexed_search抓取时会完整保留URL结构，访问时也能自动解析回原始Extbase参数。

2. 强制indexed_search抓取指定GET参数 #

如果暂时不想用友好URL，可在页面TypoScript模板中配置，让indexed_search抓取时带上Extbase参数：

config.tx_indexed_search {
  additionalGetParameters {
    10 = tx_test_show[action]
    20 = tx_test_show[controller]
    30 = tx_test_show[uid]
  }
}

该配置会告诉索引程序，抓取页面时必须包含这几个关键GET参数，避免URL被截断。

3. 修正详情页的Canonical标签 #

如果详情页输出的canonical链接只包含domain.com/detail，indexed_search会优先使用这个简化URL。需要在Extbase的show动作模板中输出正确的canonical链接：

<f:link.page 
  pageUid="{settings.detailPageUid}" 
  additionalParams="{tx_test_show: {action: 'show', controller: 'Test', uid: testItem.uid}}" 
  absolute="1" 
  rel="canonical" 
/>

也可通过TypoScript自动配置：

config {
  canonicalLink = 1
  tx_extbase.plugin.tx_test_show.settings.detailPageUid = 123 # 替换为你的详情页UID
}

4. 检查索引排除参数设置 #

确认config.tx_indexed_search.excludeParameters中没有排除tx_test_show相关参数，默认配置不会排除，但如果有自定义规则，需确保：

config.tx_indexed_search.excludeParameters = # 不要包含tx_test_show的任何参数

5. 重新生成索引 #

完成上述配置后，进入后台「索引搜索」模块，删除现有索引条目，重新执行完整的索引抓取操作，确保新配置生效。

内容的提问来源于stack exchange，提问作者Nilik