Symfony 5 的 Nginx 配置关键在于：root 必须指向 public 目录，index 必须显式声明为 index.php，try_files 必须使用 /index.php?$query_string 透传查询参数，SCRIPT_FILENAME 应用 $realpath_root 避免路径错误，并通过 fastcgi_param 正确传递 APP_ENV、APP_DEBUG 和 HTTPS 环境变量。
try_files 是 Symfony 5 在 Nginx 下能跑起来的关键，不是靠 rewrite，也不是靠 fastcgi_pass 单独就能解决的。配置错一个路径或漏掉 index.php，就会 404 或直接下载 PHP 文件。
root 和 index 必须指向 public 目录
Symfony 5 的入口文件 index.php 已移到 public/ 子目录，Nginx 的 root 必须精确到这一层，否则 $uri 匹配不到静态资源，PHP 脚本也找不到。
-
root /var/www/my-symfony-project/public;✅（正确） -
root /var/www/my-symfony-project;❌（会导致/favicon.ico404、/css/app.css404）
同时必须显式声明 index index.php;，否则 Nginx 不会自动尝试 index.php 作为默认索引——即使 try_files 后面写了它，没这行也会在某些路径下失效。
location / 的 try_files 必须带 $query_string
很多老教程用 try_files $uri $uri/ /index.php;，但在 Symfony 5 中，这会导致路由参数（如 ?page=2）丢失，因为查询字符串没透传给 index.php。
- ✅ 正确写法：
try_files $uri $uri/ /index.php?$query_string; - ❌ 错误写法：
try_files $uri $uri/ /index.php;（$_GET为空） - ❌ 更错写法：
try_files $uri $uri/ /index.php?/$1;（这是 Symfony 3/4 的旧规则，5 不认）
注意：这里不能用 $args 替代 $query_string，二者行为不完全等价；$query_string 是原始未解码的字符串，更安全。
PHP 处理块要避免 SCRIPT_FILENAME 错位
常见错误是直接复制 Apache 的 DocumentRoot 思路，把 SCRIPT_FILENAME 写成 $document_root$fastcgi_script_name，但 Nginx 的 $document_root 是你设的 root 值（即 public/），而 index.php 就在那一层，所以没问题；但如果你用了 alias 或嵌套 location，就容易出错。
- ✅ 推荐写法：
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;（$realpath_root自动解析软链接，更健壮） - ✅ 备选写法：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;（仅当确认没用 symlink 且root设置无误时可用） - ❌ 危险写法：
fastcgi_param SCRIPT_FILENAME /var/www/my-symfony-project/public$fastcgi_script_name;（硬编码路径，迁移即崩）
另外，fastcgi_split_path_info 在 Symfony 5 中已不需要——它只用于支持 PATH_INFO 的老旧模式，现代 Symfony 全靠 REQUEST_URI 解析路由，删掉这行反而更干净。
HTTPS 和环境变量别漏掉 APP_ENV
生产环境不设 APP_ENV=prod，缓存不会生效；不设 APP_DEBUG=0，错误页面会暴露敏感信息。这些得通过 fastcgi_param 传进 PHP。
- 必须加：
fastcgi_param APP_ENV prod; - 必须加：
fastcgi_param APP_DEBUG 0; - 如果强制 HTTPS：
fastcgi_param HTTPS on;（配合 Nginx 的listen 443 ssl）
这些参数不写进 fastcgi block 里，bin/console 检查环境会显示 dev，cache:clear 也清不干净——因为 PHP 进程根本不知道自己该跑在哪种环境里。
$realpath_root 和 $query_string 的组合效果：前者防路径解析错误，后者保请求完整性。少一个，都可能让路由匹配失败或参数消失，而且错误现象很隐蔽——页面能打开，但分页、搜索、表单提交全不对劲。 
