Symfony5.4升级后Kubernetes集群中PHP-FPM异常问题求助

问题复现场景 #

项目升级至Symfony 5.4后，部署到Kubernetes集群Pod中时PHP-FPM停止工作，仅同时满足以下两个条件时触发：

• 使用Symfony 5.4包
• 部署在远程Kubernetes集群

已确认的排除项：

• K8s集群中回退到Symfony 4.4可正常运行
• 本地环境升级至Symfony 5.4后PHP-FPM正常工作，PHP版本、配置与K8s环境一致
• 已排除资源不足问题
• 执行缓存预热、Symfony迁移操作无异常
• 注释OPcache配置后问题仍存在
• 注释entrypoint中的nginx -g 'daemon off;' &命令后，PHP-FPM可正常启动

排查与解决方向 #

1. 检查Symfony 5.4新增的Nginx配置规则

Symfony 5.4对官方Nginx配置做了细节调整，可能存在与K8s环境不兼容的规则：

• 对比Symfony 4.4与5.4的官方Nginx配置差异，重点关注：
  • try_files规则是否新增了额外的路径匹配逻辑
  • fastcgi_split_path_info的正则表达式是否更严格，导致请求转发异常
  • 静态资源的expires或cache-control配置是否引发Nginx启动时的加载阻塞
• 临时复用Symfony 4.4的Nginx配置到5.4项目中，测试是否能同时启动PHP-FPM和Nginx

2. 修复Entrypoint脚本的进程管理逻辑

K8s Pod中用&后台启动多进程容易引发资源抢占或启动顺序问题，建议调整脚本逻辑：

• 避免同时后台启动两个进程，改用先启动PHP-FPM并等待就绪，再启动Nginx的顺序：

  # 后台启动PHP-FPM
  php-fpm -D
  # 等待PHP-FPM 9000端口就绪（需提前安装nc工具）
  until nc -z localhost 9000; do sleep 1; done
  # 前台启动Nginx（K8s要求主进程前台运行）
  nginx -g 'daemon off;'
  

• 或者使用supervisord等进程管理工具统一管理两个进程，确保K8s能正确监控进程状态

3. 排查K8s环境的权限与网络差异

本地与K8s环境的文件权限、网络配置差异可能触发Symfony 5.4的严格校验：

• 检查Pod中var/cache、var/log、public目录的权限，确保Nginx和PHP-FPM进程（通常是www-data用户）拥有读写权限
• 查看Pod的securityContext配置，确认是否限制了进程的端口占用、文件访问或系统调用
• 查看Pod日志定位具体错误：

  # 查看PHP-FPM日志
  kubectl logs <pod-name> -c php-fpm
  # 查看Nginx日志
  kubectl logs <pod-name> -c nginx
  

4. 校验PHP-FPM与Nginx的通信配置

Symfony 5.4可能默认调整了PHP-FPM的监听方式，导致Nginx连接异常：

• 检查PHP-FPM的www.conf配置，确认listen参数：
  • 若为TCP方式：listen = 127.0.0.1:9000，需确保Nginx配置中fastcgi_pass 127.0.0.1:9000;匹配
  • 若为Unix套接字：listen = /run/php-fpm.sock，需确保Nginx进程有权限访问该套接字文件，且路径未被K8s挂载卷覆盖
• 测试Nginx与PHP-FPM的连通性：在Pod中执行curl -I http://localhost，查看返回的错误信息

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