php升级后500错误主因是php-fpm未启动或配置不匹配，需检查systemctl status、socket路径、nginx include、站点绑定版本及php.ini扩展四者是否对齐。
PHP 升级后站点 500 错误，先确认是不是 php-fpm 没起来
宝塔升级 PHP 后最常见现象是站点直接 500，但面板里网站状态显示“运行中”——这大概率是新版本 php-fpm 进程根本没启动成功，或者监听端口/套接字路径和站点配置对不上。
别急着回滚，先 SSH 登录，执行：systemctl status php-fpm-8.2（把 8.2 换成你实际升级的目标版本），看输出里有没有 failed 或 Permission denied。常见原因是：旧版 php.ini 被覆盖后启用了不兼容的扩展（比如 zend_extension=opcache.so 路径变了），或 www.conf 里 listen 值仍指向旧 socket（如 /tmp/php-cgi-74.sock），而新版默认用 /tmp/php-cgi-82.sock。
回滚 PHP 版本：用宝塔命令行工具比面板更稳
面板界面点“卸载”再重装旧版，容易残留配置、触发自动重启失败；推荐用宝塔内置命令行工具直接切换：bt 8 进入 PHP 管理菜单 → 选“切换 PHP 版本” → 输入旧版编号（如 74 表示 PHP 7.4）。该操作会：
• 自动停掉当前 php-fpm 实例
• 切换 /www/server/php 下的软链接指向旧版目录
• 重载 php-fpm 配置并启动
注意：如果之前手动改过 /www/server/php/74/etc/php-fpm.d/www.conf，切换后这些修改仍保留；但若升级时宝塔自动备份了旧配置（默认在 /www/server/php/74/etc/php-fpm.d/www.conf.bak），可对比恢复。
站点配置里的 PHP 版本绑定必须手动同步
宝塔不会自动更新网站设置里绑定的 PHP 版本。即使 PHP 回滚了，站点仍可能卡在“使用 PHP-8.2”，导致 502 Bad Gateway。
检查方法：
• 进面板 → 网站 → 设置 → PHP 版本 → 看下拉选中的是不是已回滚的版本（如 PHP-7.4）
• 更可靠的是查 Nginx 配置文件：/www/server/panel/vhost/nginx/你的域名.conf，找 include enable-php-82.conf; 这类行，手动改成 enable-php-74.conf
• 改完务必执行：nginx -t && systemctl reload nginx，否则配置不生效。
扩展与 php.ini 差异是隐形炸弹
不同 PHP 小版本之间，扩展名、函数行为、默认开关都可能变化。比如：
• PHP 8.1+ 默认禁用 mysql_connect()，但老程序还在用
• gd 扩展在 8.0+ 不再默认启用，需手动开启
• memory_limit 默认值从 128M 变成 256M，某些内存敏感的老程序反而崩得更快
建议：
• 回滚后先不要急着开站，进 /www/server/php/74/etc/php.ini，对照旧备份（如有）检查以下项：
extension=gd.so
extension=mysqli.so
date.timezone = Asia/Shanghai
• 用 php -m 和 php --ini 确认加载的扩展和配置路径是否正确
• 开启 error_log 并设 display_errors = On（临时），能快速暴露语法或函数兼容问题
立即学习“PHP免费学习笔记（深入）”；
宝塔升级 PHP 后异常，核心不在“升没升成功”，而在“配置链是否全对齐”——php-fpm 进程、Nginx 的 include、站点绑定版本、php.ini 扩展四者缺一不可。最容易被忽略的是 Nginx 配置里那行 include，它不会随 PHP 切换自动更新。 
