Symfony 5.2项目部署Apache环境.htaccess配置异常导致页面重定向循环

触发重定向循环的常见诱因 #

• 目录放置位置错误：Symfony 5.2的合法Web入口位于public/目录，若.htaccess被直接放在项目根目录、而非public/目录下，会让请求转发逻辑反复命中跳转规则，形成循环。
• 虚拟主机配置不匹配：Apache虚拟主机的DocumentRoot未指向项目public/子目录，而是直接指向项目根路径，会触发内置重写逻辑的循环判定。
• 环境变量配置偏差：Symfony运行在非内置开发服务时，需基于实际访问域名生成内部跳转地址，若APP_URL配置和实际访问地址不匹配，会产生无限301跳转。
• 路径计算规则不适配：原有重写规则的BASE路径计算逻辑在Apache 2.4+环境、或项目部署在子目录场景下，会出现路径偏移，导致重写目标不断被重新赋值。

可落地的调整步骤 #

1. 修正文件与目录结构 #

• 将Apache虚拟主机的DocumentRoot直接指向项目的public/目录绝对路径，避免将项目本身作为Web根目录。
• 将.htaccess文件放置到public/目录下，不要在项目根目录额外放置生效的重写规则文件。

2. 调整后的.htaccess配置 #

适配Apache 2.4+版本的完整可运行配置如下：

DirectoryIndex index.php

<IfModule mod_negotiation.c>
    Options -MultiViews
</IfModule>

<IfModule mod_rewrite.c>
    RewriteEngine On

    # 修正BASE路径匹配规则，避免路径计算偏差
    RewriteCond %{REQUEST_URI}::$0 ^(/.+)/(.*)::\2$
    RewriteRule ^(.*) - [E=BASE:%1]

    # 保留Auth请求头透传规则
    RewriteCond %{HTTP:Authorization} .+
    RewriteRule ^ - [E=HTTP_AUTHORIZATION:%0]

    # 增加循环判定锁，避免入口文件重复跳转
    RewriteCond %{ENV:REDIRECT_STATUS} =""
    RewriteRule ^index\.php(?:/(.*)|$) %{ENV:BASE}/$1 [R=301,L]

    # 静态资源直接放行，其余请求统一转发到入口
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ %{ENV:BASE}/index.php [L]
</IfModule>

<IfModule !mod_rewrite.c>
    <IfModule mod_alias.c>
        RedirectMatch 307 ^/$ /index.php/
    </IfModule>
</IfModule>

3. 配套环境校验 #

• 确认Apache已正常加载mod_rewrite、mod_env模块，无模块缺失。
• 修改项目根目录.env文件中的APP_URL值为实际访问的完整域名，移除本地开发默认的127.0.0.1:8000配置。
• 若项目部署在域名下的子目录（例如https://your-domain.com/symfony），需在public/.htaccess的RewriteEngine On行下方补充RewriteBase /symfony/，修正子路径下的跳转逻辑。

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