TYPO3 12 routeEnhancer配置imported_slug友好URL失效求助

核心问题：PersistedAliasMapper的误用 #

你配置的PersistedAliasMapper会自动将URL中的imported_slug解析为对应记录的uid，而非保留原始slug字符串——这就是调试时看到uid而非传入slug的原因。该mapper的作用是实现「别名（slug）<-> uid」的双向映射，但你需要的是直接传递slug参数到控制器，无需转换。

修正步骤 #

1. 调整Route Enhancer的Aspects配置 #

移除PersistedAliasMapper，改用RegularExpressionMapper仅做格式验证（或直接删除aspects节点，用requirements做基础验证）：

修改后的config.yaml：

routeEnhancers:
  PnProducts:
    type: Extbase
    extension: PnProducts
    plugin: Products
    limitToPages:
      - 142       # PID Deiner Produkt-Detailseite
    routes:
      - routePath: '/{imported_slug}'
        _controller: 'Product::show'
        _arguments:
          imported_slug: 'imported_slug'
      # optional: Listing
      - routePath: '/'
        _controller: 'Product::list'
    defaultController: 'Product::list'
    defaults:
      page: '1'
    requirements:
      imported_slug: '^[a-z0-9\-]+$' # 修正正则，匹配连字符，避免匹配斜杠导致路由冲突
    aspects:
      imported_slug:
        type: RegularExpressionMapper
        regex: '^(?P<imported_slug>[a-z0-9\-]+)$'

2. 简化控制器参数接收逻辑 #

无需手动从request获取参数，直接使用框架注入的参数即可：

/**
 * action show
 *
 * @return ResponseInterface
 */
public function showAction(string $imported_slug): ResponseInterface {
    $product = $this->productRepository->findOneByImportedSlug($imported_slug);
    if (!$product) {
        // 处理产品不存在的场景，比如抛出404异常
        throw new \TYPO3\CMS\Core\Exception\PageNotFoundException('Product not found');
    }
    $options = $this->getOptions();
    // 后续业务逻辑...
}

3. 清除缓存 #

修改配置后，必须清除TYPO3所有缓存（包括配置缓存、路由缓存），确保新配置生效。

额外检查点 #

• 确认tx_pnproducts_domain_model_product表中imported_slug字段值无重复，且格式符合正则要求
• 验证链接生成逻辑：生成产品链接时，确保传递的是imported_slug参数而非uid
• 检查页面PID配置：limitToPages中的142确实是产品详情页的PID，且插件已正确挂载到该页面

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