Symfony 5 Apache环境下路由需加/index.php前缀问题求助

核心问题是Apache的URL重写规则未生效，导致请求无法自动转发到index.php前端控制器。按以下步骤排查修复：

1. 启用Apache重写模块
   执行命令开启rewrite模块，然后重启Apache：

   sudo a2enmod rewrite
   sudo systemctl restart apache2
   

2. 检查Apache站点配置
   编辑你的站点配置文件（通常位于/etc/apache2/sites-available/your-project.conf），确保以下配置正确：

   • DocumentRoot指向Symfony项目的public目录
   • <Directory>块中设置AllowOverride All，允许.htaccess文件生效
     示例配置：

   <VirtualHost *:80>
       ServerName example.com
       DocumentRoot /var/www/your-symfony-project/public
   
       <Directory /var/www/your-symfony-project/public>
           AllowOverride All
           Require all granted
           Options -Indexes +FollowSymLinks
       </Directory>
   
       ErrorLog ${APACHE_LOG_DIR}/your-project-error.log
       CustomLog ${APACHE_LOG_DIR}/your-project-access.log combined
   </VirtualHost>
   

   修改后重启Apache：sudo systemctl restart apache2

3. 验证/public目录下的.htaccess文件
   确保public目录存在默认的Symfony重写规则文件.htaccess，若缺失可创建并添加以下内容：

   <IfModule mod_rewrite.c>
       RewriteEngine On
   
       RewriteCond %{REQUEST_URI}::$0 ^(/.+)/(.*)::\2$
       RewriteRule .* - [E=BASE:%1]
   
       RewriteCond %{HTTP:Authorization} .
       RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
   
       RewriteCond %{ENV:REDIRECT_STATUS} =""
       RewriteRule ^index\.php(?:/(.*)|$) %{ENV:BASE}/$1 [R=301,L]
   
       RewriteCond %{REQUEST_FILENAME} -f
       RewriteRule .* - [L]
   
       RewriteRule .* %{ENV:BASE}/index.php [L]
   </IfModule>
   

4. 清除Symfony缓存
   执行缓存清理命令，确保路由配置生效：

   # 开发环境
   php bin/console cache:clear
   # 生产环境
   php bin/console cache:clear --env=prod
   

5. 检查文件权限
   确保public目录及所有文件的权限允许Apache读取，可执行以下命令设置权限：

   sudo chown -R www-data:www-data /var/www/your-symfony-project/public
   sudo chmod -R 755 /var/www/your-symfony-project/public
   

完成以上步骤后，直接访问http://example.com/lucky应该就能正常路由到对应的控制器了。

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