如何解决TYPO3中出现的「命名路由未找到」错误？

我将一个TYPO3项目复制到本地XAMPP环境中，前端运行正常，但后端列表模块无法加载，出现错误：

站点配置模块可以加载并显示条目，但尝试编辑站点配置时，会显示类似错误：

已尝试清除缓存，但无效，请问这是什么原因？

可能的原因及解决办法 #

• 数据库连接或权限问题

  1. 检查typo3conf/LocalConfiguration.php里的DB节点配置，确认主机、用户名、密码、数据库名和本地XAMPP的MySQL配置完全一致。
  2. 给本地数据库用户分配该TYPO3数据库的全量权限（包含SELECT、INSERT、UPDATE、DELETE、CREATE、ALTER等），可通过phpMyAdmin操作赋权。

• 文件/目录权限问题

  1. 调整项目目录权限：
     • Linux/macOS：执行sudo chown -R www-data:www-data /path/to/your/typo3-project，再设置目录权限为755、文件权限为644。
     • Windows：确保XAMPP的Apache服务用户（通常是SYSTEM或当前登录用户）对项目目录有读写权限，右键目录→属性→安全选项卡配置权限。
  2. 确认typo3temp/和var/目录可写，这两个目录是TYPO3缓存、临时文件存储目录，无读写权限会直接导致后端模块加载失败。

• PHP版本或扩展不兼容

  1. 核对本地XAMPP的PHP版本与原项目服务器版本是否匹配（TYPO3不同版本对PHP版本要求严格，比如TYPO3 11需PHP 7.4-8.1，TYPO3 12需PHP 8.1-8.2）。
  2. 检查PHP扩展是否齐全：TYPO3必需的扩展有mysqli、gd、json、mbstring、openssl、pdo_mysql等，在XAMPP的php.ini中启用这些扩展后重启Apache。

• 站点配置域名/路径不匹配

  1. 打开phpMyAdmin，查看sys_domain表，确认其中的域名记录和本地访问地址一致（比如本地用http://localhost/typo3-project，则域名需设为localhost/typo3-project或对应本地自定义域名）。
  2. 修改typo3conf/LocalConfiguration.php中的SYS/trustedHostsPattern配置，把本地域名加入信任列表，示例：'SYS' => [ 'trustedHostsPattern' => 'localhost|127.0.0.1', ]。

• 强制重置缓存与数据库同步

  1. 手动删除var/cache/和typo3temp/下的所有文件（保留目录本身）。
  2. 访问http://localhost/typo3-project/typo3/install进入安装工具，依次点击"清除所有缓存"、"数据库分析"、"数据库更新"，确保数据库结构和当前TYPO3版本匹配。

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