TYPO3 v13首次安装后后台登录返回Apache 404错误求助

1. 确认Apache重写模块与权限配置 #

• 执行命令启用重写模块：a2enmod rewrite，重启Apache生效：systemctl restart apache2
• 检查虚拟主机配置，确保DocumentRoot对应的目录块中设置了AllowOverride All（默认可能是AllowOverride None，会导致.htaccess失效）：

  <Directory /var/www/your-typo3-project/public>
      AllowOverride All
      Require all granted
  </Directory>
  

2. 验证TYPO3的.htaccess文件 #

• 确认Composer安装的项目根目录（通常是public/）下存在TYPO3自动生成的.htaccess，且typo3/子目录下也有对应的.htaccess文件
• 检查根目录.htaccess中是否包含针对后台路径的重写规则，比如：

  RewriteRule ^typo3/(.*)$ typo3/index.php [L]
  

• 若文件缺失或规则异常，执行命令重新生成：./vendor/bin/typo3 setup:fixfolderstructure

3. 排查DocumentRoot配置错误 #

• 务必确保Apache虚拟主机的DocumentRoot指向TYPO3的web根目录（Composer安装为public/目录），而非包含vendor/、composer.json的项目根目录——错误的根目录会导致/typo3路径无法映射到正确的PHP入口文件

4. 测试重写规则有效性 #

• 在public/目录创建测试脚本test.php：

  <?php echo "Rewrite module works"; ?>
  

• 访问typo3.my.domain.com/test/any-random-path，若能输出内容，说明重写模块与权限配置正常；若返回404，继续排查Apache配置
• 直接访问typo3.my.domain.com/typo3/index.php，若能加载后台登录页的基础框架，说明重写规则未正确匹配请求

5. 开启Apache重写日志排查细节 #

• 在虚拟主机配置中添加日志级别：

  LogLevel rewrite:trace6
  

• 重启Apache后再次访问后台，查看/var/log/apache2/error.log，可看到重写规则的匹配过程，定位具体哪一步未转发到PHP入口

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