Typo3 11.5 RouteEnhancer未生效？配置是否有误？

配置可能存在的错误点 #

1. 扩展与插件Key大小写不匹配 #

URL中的参数前缀是tx_my_products_subcategory，对应TYPO3命名规则为tx_{extension_key}_{plugin_key}。需注意：

• extension_key必须为小写下划线格式（你的扩展实际key应为my_products）
• plugin_key需与插件注册时的key保持一致（应为subcategory）

当前配置中extension: MyProducts和plugin: Subcategory可能是类名而非实际的扩展/插件key，建议修改为：

Products:
  type: Extbase
  extension: my_products
  plugin: subcategory
  # 其余配置保持不变

2. PersistedAliasMapper字段唯一性问题 #

PersistedAliasMapper要求routeFieldName指定的字段具备全局唯一性：

• 确认tx_myproducts_domain_model_subcategory表中的name字段无重复值，重复值会直接导致路由映射失败
• 若name字段无法保证唯一，建议改用slug字段（需先在模型中配置自动生成slug逻辑）

3. 页面范围限制不匹配 #

检查生成当前URL的页面ID是否在limitToPages: [15,16,17,26,27,28]列表内。如果当前页面不在此范围内，该RouteEnhancer会被直接忽略。

验证TYPO3是否读取配置的方法 #

1. 后台查看站点配置 #

登录TYPO3后端，进入「配置」模块→「站点配置」，选择目标站点后查看routeEnhancers节点，确认你的Products配置项是否存在。若存在则配置已被读取；若不存在，需检查配置文件路径（正确路径为config/sites/[站点标识符]/config.yaml）或排查隐藏语法问题（如特殊空格字符）。

2. 启用前端调试模式 #

在LocalConfiguration.php中添加以下配置：

$GLOBALS['TYPO3_CONF_VARS']['FE']['debug'] = true;

清除缓存后访问目标页面，查看页面源代码末尾的注释，其中包含路由匹配的详细调试信息，可直接确认你的RouteEnhancer是否参与了URL处理。

3. 命令行查看站点配置 #

执行TYPO3 CLI命令查看当前站点的完整配置：

./vendor/bin/typo3 site:show [你的站点标识符]

在输出的routeEnhancers部分检查是否包含你的Products配置，以此确认配置是否被正确加载。

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