502错误在宝塔多版本共存时最常由PHP-FPM监听地址冲突引发，即多个实例绑定同一socket路径或TCP端口；需检查ss -tlnp | grep ':900'或ls -l /tmp/php-cgi*.sock，确保各版本listen与Nginx的fastcgi_pass严格一一对应，并停止后启动服务而非仅重载。
PHP-FPM监听地址冲突导致502错误
宝塔多版本共存时最常触发502，根本原因不是PHP没装好，而是多个php-fpm实例监听了同一地址。默认情况下，宝塔给每个版本分配不同的Unix socket路径（如/tmp/php-cgi-74.sock、/tmp/php-cgi-81.sock），但一旦你手动改过配置或恢复过备份，就容易出现重复监听/tmp/php-cgi-74.sock或全指向127.0.0.1:9000的情况。
检查方法：执行ss -tlnp | grep ':900'或ls -l /tmp/php-cgi*.sock，看是否有多个进程绑在同一个端口或文件上。
- 若发现多个
php-fpm进程监听127.0.0.1:9000，立刻停掉所有PHP版本，再逐个修改其www.conf里的listen为唯一值（如127.0.0.1:9001、127.0.0.1:9002） - 若用Unix socket，确保
listen = /tmp/php-cgi-74.sock与对应Nginx的fastcgi_pass unix:/tmp/php-cgi-74.sock完全一致，大小写和路径都不能差一个字符 - 改完必须「停止→启动」PHP服务，不能只「重载」；Nginx侧则只需「重载配置」
环境变量PATH混乱导致CLI调用错版本
你在终端敲php -v看到的是PHP 7.4，但网站跑的是8.1，这说明CLI和Web运行时根本不是一回事——宝塔不干预系统PATH，php命令永远走which php的结果，跟网站配置无关。
常见陷阱：有人为了图方便，把/www/server/php/82/bin硬塞进/etc/profile，结果宝塔后台某些Python脚本（比如计划任务模块）突然报错，因为它们依赖系统级php做校验。
立即学习“PHP免费学习笔记（深入）”；
- 不要动
/usr/bin/php软链接，宝塔自己会维护它，但仅用于面板内部，不影响你的项目 - 需要终端用指定版本？临时用
export PATH="/www/server/php/82/bin:$PATH"，永久生效就加到~/.bashrc，别碰全局 - 部署脚本里别写
php artisan，改用/www/server/php/82/bin/php artisan，绝对路径最稳
Nginx fastcgi_pass未同步PHP-FPM监听变更
你改了PHP 8.1的www.conf，把listen从socket改成127.0.0.1:9001，但Nginx配置里还是fastcgi_pass unix:/tmp/php-cgi-81.sock——这是宝塔多版本共存里最高频的手动疏漏。
宝塔「切换PHP版本」按钮只会更新站点绑定关系，不会读取你手改过的www.conf，更不会反向修正Nginx配置。它只认面板界面上那个下拉菜单选中的版本，然后套用默认模板生成fastcgi_pass。
- 进宝塔 → 网站 → 对应站点 → 配置文件，搜
fastcgi_pass，确认它和该PHP版本实际监听地址严格匹配 - 如果用了自定义Nginx模板（比如加了
include其他conf），那些文件里的fastcgi_pass也得一并检查 - 改完保存后，务必点「重载Nginx」，不是重启，也不是重载PHP
php.ini与扩展目录未隔离引发函数不可用
网站报Call to undefined function mysqli_connect()或Class 'Redis' not found，不是PHP没装扩展，而是扩展没装到当前版本的extension_dir里，或者php.ini加载了别的版本的配置。
每个PHP版本的php.ini默认在/www/server/php/xx/etc/php.ini，但如果你之前复制过配置、用过一键迁移工具，很可能extension_dir还指着/www/server/php/74/libphp/extensions/no-debug-non-zts-20190902这种老路径。
- 进宝塔 → 软件商店 → 找到目标PHP版本 → 设置 → 配置修改，确认
php.ini路径正确，且extension_dir值是当前版本的（如/www/server/php/82/libphp/extensions/no-debug-non-zts-20220829） - 扩展必须在对应PHP版本的「安装扩展」页面里勾选安装，不能拷.so文件过去就完事——ABI不兼容，
undefined symbol直接拒载 - 检查
phpinfo()输出页的「Loaded Configuration File」和「Scan this dir for additional .ini files」两行，确保都落在当前版本目录下
