PHP-FPM未启动导致502或PHP文件下载，需依次排查：进程状态、日志错误、socket权限与路径、Nginx fastcgi_pass配置、扩展兼容性及SELinux策略。
PHP-FPM 服务根本没起来
宝塔面板显示 PHP 已安装，但访问 .php 文件直接下载或 502，第一反应不是配置问题，而是 php-fpm 进程压根没跑起来。常见现象是面板里 PHP 状态显示“已停止”，或者用命令 systemctl status php-fpm-74（版本号替换成你实际用的）看到 inactive (dead) 或 failed。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先查日志：
tail -n 20 /www/server/php/74/var/log/php-fpm.log（路径中74换成你的版本），重点看最后一行是否报unable to bind socket或failed to load configuration file - 检查
php-fpm.conf里pid和error_log路径是否存在、权限是否为www:www；常见坑是重装后旧 pid 文件残留，导致新进程无法绑定端口 - 确认
www用户对/tmp/php-cgi-74.sock（或对应版本的 sock 文件）有读写权，否则 Nginx 找不到通信入口，直接 502
Nginx 配置里 fastcgi_pass 指向错误
即使 php-fpm 在跑，Nginx 仍可能因转发地址错而无法解析 PHP。宝塔默认用 Unix socket（如 unix:/tmp/php-cgi-74.sock），但重装 PHP 后若没同步更新站点配置，就容易沿用旧路径或误配成 127.0.0.1:9000 —— 而新版 PHP-FPM 可能监听的是 socket，不是 TCP 端口。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 进宝塔 → 网站 → 对应站点 → 配置文件，搜索
fastcgi_pass，确认值与当前 PHP 版本匹配，比如 PHP 8.2 就该是unix:/tmp/php-cgi-82.sock - 如果用了 TCP 模式（即
127.0.0.1:9000），必须去/www/server/php/74/etc/php-fpm.d/www.conf里把listen = 127.0.0.1:9000解注并注释掉listen = /tmp/php-cgi-74.sock，否则两边对不上 - 改完务必执行
nginx -t校验语法，再systemctl reload nginx，别只点面板“重载配置”——有时它不生效
PHP 扩展模块缺失导致启动失败
重装 PHP-FPM 后服务起不来，php-fpm.log 里出现 PHP Warning: PHP Startup: Unable to load dynamic library 'xxx.so'，说明某个扩展（比如 redis.so、imagick.so）依赖的底层库变了，或路径失效了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
php -m查已加载模块，对比重装前后差异；再用php --ini确认Loaded Configuration File是哪个php.ini，避免改错文件 - 进
/www/server/php/74/lib/php/extensions/no-debug-non-zts-20200930/（路径随 PHP 版本和编译参数变），检查报错的.so文件是否存在；不存在就重新编译安装对应扩展，别直接复制旧版文件 - 某些扩展（如
swoole）需匹配 PHP 主版本和 ABI，PHP 7.4 升到 8.0 后，旧swoole.so会直接让php-fpm启动崩溃，日志里只显示段错误，得用strace -f php-fpm -t追踪
SELinux 或安全策略拦截 socket 通信
CentOS/RHEL 系统上重装后 PHP 正常、Nginx 正常，但就是 502，php-fpm.log 无报错，nginx error.log 显示 connect() to unix:/tmp/php-cgi-74.sock failed (13: Permission denied) —— 很大概率是 SELinux 拦了 socket 访问。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 临时验证：运行
setenforce 0，再试访问，如果好了，就是 SELinux 问题 - 永久修复不是关 SELinux，而是加规则：
semanage fcontext -a -t httpd_var_run_t "/tmp/php-cgi-.*\.sock"，然后restorecon -Rv /tmp/ - 注意宝塔自建的 sock 路径可能不在
/tmp，比如在/www/php-sock/，那就得对应改semanage的路径正则
重装 PHP-FPM 不是点几下按钮就完事，核心是确保进程活着、Nginx 找得到它、扩展不拖后腿、系统策略不拦路——四个环节漏一个，PHP 文件就还是不解析。
