TYPO3 v13中GET参数引发404错误，如何恢复正常行为？

1. 调整路由配置 #

TYPO3 v13默认启用严格路由匹配，会误将GET参数识别为路径部分。需在站点的config.yaml中修改路由规则，允许查询参数：

routeEnhancers:
  PageTypeSuffix:
    type: PageType
    default: ''
    index: ''
    map:
      '': 0

或者直接在路由规则中明确允许所有查询参数：

routes:
  - route: '/'
    type: Page
    options:
      access: true
      queryParameters: '*'

2. 启用站点的查询参数允许选项 #

进入TYPO3后端的站点管理模块，打开对应站点的配置面板，找到「URL配置」区域，确保「允许查询参数」选项处于启用状态。该选项禁用时，系统会强制将查询参数当作路径处理。

3. 检查Web服务器配置 #

• Apache环境：确认.htaccess中的重写规则包含QSA标志，确保查询参数被正确保留：

  RewriteRule ^(.*)$ index.php?/$1 [L,QSA]
  

• Nginx环境：调整try_files指令，保证查询参数传递到入口文件：

  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }
  

4. 清除缓存 #

修改配置后，必须清除TYPO3全量缓存（包括页面缓存、配置缓存），确保新配置生效。可以通过后端的「清除缓存」按钮操作，或执行命令行：

typo3 cache:flush

5. 验证修复结果 #

访问问题示例URL https://example.com/mypage?sword=something，确认不再返回404错误，且系统能正常读取sword参数。

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