TYPO3 Route Enhancers：列表+详情页分页配置问题求助

你遇到的分页链接丢失分类参数、路由匹配错误的问题，我之前配置TYPO3 Extbase路由时也碰到过——核心原因是路由顺序不合理、分页参数的Aspect配置缺失，加上路由规则的优先级冲突导致的。下面是针对你的需求优化后的完整配置，同时拆解关键要点帮你理解：

完整的Route Enhancers配置 #

routeEnhancers:
  RecipeListDetail:
    type: Extbase
    limitToPages: [2]
    extension: Myext
    plugin: Pi1
    routes:
      # 1. 详情视图：带分类的Recipe详情（最具体的路由，必须放最前面）
      - { routePath: '/{category_title}/{recipe_title}', _controller: 'Recipe::show', _arguments: {'category_title': 'category', 'recipe_title': 'recipe'} }
      # 2. 列表视图：带分类+分页
      - { routePath: '/{category_title}/page-{page}', _controller: 'Recipe::list', _arguments: {'category_title': 'category', 'page': '@widget_0/currentPage'} }
      # 3. 列表视图：仅分类
      - { routePath: '/{category_title}', _controller: 'Recipe::list', _arguments: {'category_title': 'category'} }
      # 4. 列表视图：仅分页
      - { routePath: '/page-{page}', _controller: 'Recipe::list', _arguments: {'page': '@widget_0/currentPage'} }
      # 5. 列表视图：根路径（无分类无分页）
      - { routePath: '/', _controller: 'Recipe::list' }
    defaultController: 'Recipe::list'
    aspects:
      category_title:
        type: PersistedAliasMapper
        tableName: sys_category
        routeFieldName: tx_myext_slug
      recipe_title:
        type: PersistedAliasMapper
        tableName: tx_myext_domain_model_recipe
        routeFieldName: slug
      # 分页参数的Aspect配置：处理数字分页，必须加！
      page:
        type: NumberAspect
        fallbackValue: 1
        minimum: 1

关键配置说明 #

1. 路由顺序是核心 #

TYPO3的Route Enhancers是从上到下匹配路由，所以一定要把更具体的路由放在最前面：

• 详情路由（/{category_title}/{recipe_title}）最特殊，必须优先匹配，不然像/desserts/chocolate-cake这种详情URL可能会被误判为列表分页。
• 然后依次是带分类+分页、仅分类、仅分页，最后是最通用的根路径列表路由——这样能保证每个URL都匹配到最精准的规则。

2. 分页Aspect不能省 #

新增的page Aspect是解决丢参数的关键：

• 用NumberAspect限定分页参数为数字，同时设置fallbackValue:1，没有分页参数时默认显示第一页。
• 这个配置能让TYPO3正确解析page-{n}格式的参数，生成分页链接时也会自动带上当前的分类参数，不会丢失。

3. 模板里的分页Widget要加参数 #

在Fluid模板的分页组件里，必须加上useRouteParameters="1"，这样分页链接才会自动保留当前的路由参数（比如选中的分类）：

<f:widget.paginate objects="{recipes}" as="paginatedRecipes" configuration="{itemsPerPage: 10, useRouteParameters: 1}">
  <!-- 你的Recipe列表内容 -->
</f:widget.paginate>

为什么你的原有配置出问题？ #

1. 路由顺序搞反了：你把带分页的路由放在前面，但没优先处理详情路由，导致部分详情URL被误匹配成列表。
2. 缺了分页Aspect：没有配置page的规则，TYPO3不知道怎么处理分页参数，生成链接时自然带不上分类。
3. 路由路径格式冲突：你用了/category-{category_title}的格式，和需求里的/category不一致，直接导致路由匹配混乱。

按上面的配置调整后，就能完美支持你需要的所有URL格式，分页链接也会正确保留分类参数了。

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