安装TYPO3后输入管理员凭证跳转提示请求URL未找到报错

问题现象 #

本地部署TYPO3后可正常访问后台登录页面，提交管理员账号密码后触发报错：

The requested URL was not found on this server
（译文：服务器上未找到请求的URL）

排查&修复步骤 #

1. 检查URL重写规则配置 #

这是该场景下最高发的原因，TYPO3依赖Web服务器的重写规则实现路由跳转：

• 若使用Apache服务器：
  • 确认站点根目录下存在.htaccess文件，没有的话从TYPO3官方发行包的public目录下复制默认.htaccess文件到你的站点根目录
  • 确认Apache已开启mod_rewrite模块，可通过apache2ctl -M | grep rewrite命令检查，无输出的话执行a2enmod rewrite开启后重启Apache
  • 确认站点配置中AllowOverride参数设为All，否则.htaccess规则不会生效
• 若使用Nginx服务器：
  • 确认站点配置中已加入TYPO3适配的重写规则，核心规则示例：

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

  修改配置后执行nginx -s reload重载配置

2. 校验TYPO3站点基础配置 #

• 检查config/system/additional.php或config/system/settings.php文件中的trustedHostsPattern配置，确保值匹配你本地访问的域名/IP，本地环境配置示例：

  'trustedHostsPattern' => 'localhost|127\.0\.0\.1',
  

• 确认BE' => ['serverPath']配置与你本地站点的实际根路径一致

3. 检查后台入口路径配置 #

部分本地部署场景会自定义后台入口路径，需确认提交登录后的跳转路径是否存在：

• 默认后台入口为/typo3，若你修改过后台入口别名，需确认对应路径的重写规则也同步更新
• 登录后跳转的目标页面如果是自定义模块，可先清空TYPO3缓存目录var/cache下的所有文件后重试

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