FOSUserBundle与Symfony3.4：生产环境登录页出现404错误

我之前维护Symfony 3.4项目时也碰到过类似的生产环境路由问题，结合你用的FOSUserBundle 2.1.2，给你几个针对性的排查和解决步骤，应该能搞定：

1. 确认生产环境是否加载了FOSUserBundle的路由 #

开发环境会自动加载所有bundle的路由，但生产环境需要你明确导入。打开app/config/routing.yml，检查是否有以下配置：

fos_user:
    resource: "@FOSUserBundle/Resources/config/routing/all.xml"

如果配置存在但被imports的环境条件限制（比如仅在dev环境加载），生产环境就找不到登录路由。你也可以直接在服务器上执行命令验证：

bin/console router:match /login --env=prod

如果返回No routes found for "/login"，说明路由未加载，需确保上述配置在prod环境生效的路由文件中。

2. 检查Web服务器的重写规则和根目录配置 #

不管是Apache还是Nginx，生产环境URL重写配置错误都会导致/login或app.php/login返回404：

• Apache：确认web目录下的.htaccess文件存在且内容正确：

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ app.php [QSA,L]
</IfModule>

同时要确保Apache的mod_rewrite模块已启用。

• Nginx：检查站点配置里的location规则：

location / {
    try_files $uri $uri/ /app.php$is_args$args;
}

另外，务必确认Web服务器的根目录指向项目的web文件夹，而非项目根目录，这是很多人容易踩的坑。

3. 修复缓存目录的权限问题 #

清空缓存后，新生成的缓存文件权限如果不正确，Symfony可能无法读取路由配置。先给缓存和日志目录设置正确权限：

# 更安全的方式，假设Web服务器用户是www-data
chown -R www-data:www-data var/cache var/log
# 或临时开放权限测试
chmod -R 777 var/cache var/log

然后重新清理生产环境缓存：

bin/console cache:clear --env=prod --no-debug

4. 验证Security配置中的登录路由是否正确 #

打开app/config/security.yml，检查防火墙部分的登录路由配置：

security:
    firewalls:
        main:
            pattern: ^/
            form_login:
                provider: fos_userbundle
                login_path: fos_user_security_login  # 必须用路由名称，而非硬编码路径
                check_path: fos_user_security_check
                csrf_token_generator: security.csrf.token_manager
            logout: true
            anonymous: true

如果login_path写的是/login而非路由名称fos_user_security_login，生产环境路由生成可能出问题，改成路由名称即可。

5. 排查是否有自定义路由冲突 #

执行命令查看生产环境的所有路由：

bin/console debug:router --env=prod

看看有没有自定义路由覆盖了/login路径，或者fos_user_security_login对应的路径是否为/login。若有冲突，调整自定义路由的路径即可。

内容的提问来源于stack exchange，提问作者Saint - Cyr MAPOUKA