Symfony 5.4生产环境异常：访问缺失图片触发500错误

核心方向推测 #

生产环境下缺失图片触发500而非404，大概率是Symfony生产环境的异常处理配置差异，或是服务器静态资源路由规则未正确绕过Symfony内核——导致缺失的图片请求被Symfony接管，而非直接返回404，进而抛出未捕获异常污染缓存。

具体排查修复步骤 #

1. 检查虚拟主机静态资源路由规则 #

确保Nginx/Apache的vhost配置中，静态资源请求直接由服务器处理，不转发给Symfony的index.php：

• Nginx（Plesk vhost.conf）示例：

  location ~* \.(png|jpg|jpeg|gif|ico|css|js|woff|woff2|svg)$ {
      expires 30d;
      add_header Cache-Control "public, immutable";
      try_files $uri =404; # 直接返回404，不进入Symfony请求流程
  }
  
  location / {
      try_files $uri $uri/ /index.php$is_args$args;
  }
  

  重点确认try_files $uri =404;这一行，避免缺失资源请求被Symfony处理。

• Apache（.htaccess或vhost）示例：

  <IfModule mod_rewrite.c>
      RewriteEngine On
  
      # 优先处理存在的静态资源
      RewriteCond %{REQUEST_FILENAME} -f
      RewriteRule ^ - [L]
  
      # 其余请求交给Symfony
      RewriteRule ^ index.php [L]
  </IfModule>
  

  确保静态资源判断规则在Symfony转发规则之前。

2. 检查Symfony生产环境异常配置 #

打开config/packages/prod/framework.yaml，确认以下配置：

framework:
    secret: '%env(APP_SECRET)%'
    debug: false
    error_controller: null # 使用默认错误控制器，避免自定义控制器抛出致命异常

如果自定义了错误控制器，检查其处理404场景时是否存在未捕获异常。

3. 定位缓存污染的根源 #

Symfony生产环境会缓存未捕获异常，导致后续请求持续报错。先彻底清理缓存：

php bin/console cache:clear --env=prod
chmod -R 775 var/cache var/log # 根据服务器用户组调整权限，比如www-data

然后查看var/log/prod.log中的具体错误堆栈，找到触发500的具体原因（比如某服务处理404请求时依赖缺失资源，抛出致命错误）。

4. 检查服务器PHP错误日志 #

在Plesk域名的“日志”模块查看服务器PHP错误日志，确认是否存在权限不足、扩展缺失等隐性错误——这些可能在Symfony处理请求时触发致命异常。

5. 对比测试服务器与生产服务器配置差异 #

既然相同项目在测试服务器正常，重点对比：

• PHP版本（Symfony5.4要求PHP7.2.5+，建议7.4或8.0）
• Nginx/Apache版本及配置细节
• Plesk子域名与主域名的配置差异（比如安全模块、URL重写规则）
• .env.prod中的环境变量（比如是否误设APP_DEBUG=true）

关键验证操作 #

在生产环境临时设置APP_DEBUG=true（测试后立即关闭），访问缺失图片，查看具体的500错误堆栈，这能直接定位问题根源。

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