TYPO3 sf_event_mgt路由增强器配置问题：友好URL失效

问题背景 #

使用TYPO3 12.4.13和sf_event_mgt 7.5.0，按照官方文档配置Route Enhancer后出现以下问题：

• 活动列表可正常显示，但点击进入详情页时提示「The event record is not available anymore.」
• 理想URL格式mydomain.com/event/myevent无法访问，仅mydomain.com/event/something/myevent这种子页面式slug能打开详情页，但注册页仍报错

排查与解决方案 #

1. 检查路由增强器的页面限制 #

配置中EventDetailPlugin和EventRegistrationPlugin分别限制在页面58和59，需确认：

• 插件Pieventdetail仅挂载在页面58，Pieventregistration仅挂载在页面59
• 若插件在多页面使用，移除limitToPages配置，或添加所有相关页面UID到数组中

2. 调整路由路径避免冲突 #

当前/{event_title}的短路径易与页面自身slug冲突，给路由添加前缀区分：

# 修改EventDetailPlugin路由
EventDetailPlugin:
  type: Extbase
  limitToPages: [58]
  extension: SfEventMgt
  plugin: Pieventdetail
  routes:
    -
      routePath: '/detail/{event_title}'
      _controller: 'Event::detail'
      _arguments:
        event_title: event
    -
      routePath: '/detail/{event_title}/ical'
      _controller: 'Event::icalDownload'
      _arguments:
        event_title: event
  defaultController: 'Event::detail'
  aspects:
    event_title:
      type: PersistedAliasMapper
      tableName: tx_sfeventmgt_domain_model_event
      routeFieldName: slug

# 修改EventRegistrationPlugin路由
EventRegistrationPlugin:
  type: Extbase
  limitToPages: [59]
  extension: SfEventMgt
  plugin: Pieventregistration
  routes:
    -
      routePath: '/register/{event_title}'
      _controller: 'Event::registration'
      _arguments:
        event_title: event
    -
      routePath: '/register/save-registration/{event_title}'
      _controller: 'Event::saveRegistration'
      _arguments:
        event_title: event
    # 其余路由保持不变
  defaultController: 'Event::registration'
  requirements:
    eventuid: \d+
    reguid: \d+
    result: '[0-8]'
    hmac: '^[a-zA-Z0-9]{40}$'
  aspects:
    reguid:
      type: StaticRangeMapper
      start: '1'
      end: '10000' # 根据实际注册记录数量调整
    event_title:
      type: PersistedAliasMapper
      tableName: tx_sfeventmgt_domain_model_event
      routeFieldName: slug

修改后URL格式为mydomain.com/event/detail/myevent和mydomain.com/event/register/myevent，避免路由冲突。

3. 验证活动slug唯一性 #

PersistedAliasMapper依赖slug唯一性，需：

• 后台检查所有活动记录的slug字段，确保无重复值
• 启用slug自动生成的唯一性检查

4. 清除全量缓存 #

路由配置修改后必须清除全量缓存：

• 后台点击「清除缓存」→「全部缓存」
• 命令行执行：vendor/bin/typo3 cache:flush

5. 检查活动记录状态 #

确认活动记录：

• 已勾选「已发布」状态
• 开始/结束时间设置合理，当前时间在活动有效范围内

6. 修复注册记录的路由映射错误 #

原配置中reguid使用routeFieldName: uid错误，改为数值范围映射或使用slug字段（若存在）：

# 数值范围映射示例
reguid:
  type: StaticRangeMapper
  start: '1'
  end: '10000'

# 若注册记录有slug字段，改为：
reguid:
  type: PersistedAliasMapper
  tableName: tx_sfeventmgt_domain_model_registration
  routeFieldName: slug

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