Symfony5.3子域名部署下/admin路由返回404错误排查求助

• 站点根目录配置错误：Symfony项目必须将web服务的根目录指向项目的public文件夹，若直接指向项目根目录，/admin路由无法被正确解析
• 重写规则未配置：Nginx/Apache未配置伪静态规则，所有请求没有统一转发到public/index.php入口文件处理，导致服务端将/admin当作物理目录查找，返回404
• prod环境缓存未更新：本地开发默认使用dev环境，路由变更会自动刷新缓存，服务器部署时通常使用prod环境，路由注册后未手动清理缓存会导致路由匹配失效
• 大小写敏感问题：服务器Linux系统对路径、控制器名大小写敏感，若路由注解、控制器类名存在大小写不匹配的情况，本地Windows/macOS环境可正常运行，服务器会报错
• 反向代理配置问题：若服务器使用了反向代理（如Nginx反向代理、CDN），Symfony未配置信任代理，会导致HTTPS请求的路由匹配异常

1. 修正站点根目录配置
   将Nginx/Apache的站点根目录指向Symfony项目的public文件夹，示例Nginx配置如下：

server {
    listen 443 ssl;
    server_name subdomain.domain.com;
    root /var/www/your_project/public; # 此处需指向项目public目录
    index index.php;

    location / {
        try_files $uri /index.php$is_args$args; # 所有请求统一转发到入口文件
    }

    location ~ ^/index\.php(/|$) {
        fastcgi_pass unix:/run/php/php8.0-fpm.sock; # 对应你服务器的PHP版本sock路径
        fastcgi_split_path_info ^(.+\.php)(/.*)$;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        fastcgi_param DOCUMENT_ROOT $realpath_root;
        internal;
    }
}

2. 清理prod环境缓存
   在服务器项目根目录执行以下命令：

php bin/console cache:clear --env=prod
php bin/console cache:warmup --env=prod

3. 检查大小写匹配
   确认DashboardController类名、路由注解@Route("/admin")的路径大小写完全一致，无拼写错误。
4. 配置信任代理（使用反向代理/HTTPS时需要）
   在config/packages/framework.yaml中添加信任代理配置：

framework:
    trusted_proxies: '127.0.0.1,REMOTE_ADDR' # 按需调整为你的代理IP段
    trusted_headers: ['X-Forwarded-Host', 'X-Forwarded-Port', 'X-Forwarded-Proto']

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