宝塔中composer self-update报错或无反应，首要排查php禁用函数putenv和proc_open；升级不到v2需执行composer self-update --stable；插件不兼容会导致install卡住，应清理plugins配置；宝塔软件商店的composer无法通过面板升级，须命令行操作。
宝塔里 composer self-update 报错或没反应？先看是不是卡在禁用函数上
宝塔默认会在 PHP 配置中禁用 putenv、proc_open 等函数，而 Composer v2+ 的 self-update 必须调用它们——所以你敲了命令却提示“权限不足”“无法写入”，甚至直接静默失败，大概率不是权限问题，而是 PHP 层面拦住了。
- 进宝塔 → PHP 管理 → 选择你项目用的 PHP 版本 → “禁用函数”列表里，把
putenv和proc_open删掉（保留其他默认禁用项即可） - 改完别忘了重启对应 PHP 服务（点“重载配置”或“重启”）
- 再试
composer self-update，大概率就能动了
升级不到 v2.x？因为 self-update 不跨主版本
Composer 1.x 已于 2022 年底停止维护，现在很多新包（比如要求 php >= 8.1 的 Laravel 11 或 Symfony 7）根本装不上。但如果你执行 composer self-update 后还是显示 1.10.22 这类版本号，说明它只在 1.x 内部打转，不会自动跳到 2.x。
-
composer self-update默认只升小版本（如 2.5.8 → 2.5.12），不升主版本（1.x → 2.x 或 2.x → 3.x） - 想强制切到 v2 最新版，必须显式指定：
composer self-update --stable - 如果仍失败（比如提示 GPG 校验失败或网络超时），就绕过 self-update，用官方安装脚本覆盖：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" php composer-setup.php --install-dir=/usr/local/bin --filename=composer php -r "unlink('composer-setup.php');"
升级后 composer install 卡住不动？可能是插件不兼容
v2 默认启用 plugin API v2.0，而一些老旧加速插件（比如早已废弃的 hirak/prestissimo）会直接失效，导致命令看似运行了，却卡在 “Package operations: 0 installs, 0 updates…” 不往下走。
- 检查项目根目录下的
composer.json，删掉"config": { "plugins": [...] }或整个plugins字段 - 也检查全局配置：
composer config --global --list | grep plugins，若有输出，用composer config --global --unset plugins清掉 - 临时验证：加
-n参数跳过插件加载，试试composer install -n是否能跑通
宝塔软件商店装的 Composer 能不能直接升级？基本不能
宝塔软件商店里的 Composer 安装包是静态打包的，面板 UI 上那个“升级”按钮往往只检测自己仓库里的版本，和官方源完全脱节。你点它，大概率提示“当前已是最新版本”，哪怕实际还是 v1.6.3。
- 别依赖面板按钮，一律走命令行更新
- 确认你调用的是哪个
composer：which composer，再看是不是软链接指向/usr/local/bin/composer；如果不是，self-update可能更新了错误的文件 - 升级后务必用
composer --version和composer diagnose双重验证，尤其注意diagnose输出里是否提示 “You are running Composer with SSL/TLS protection disabled.” 或 “The openssl extension is missing.” —— 这些才是真坑，比版本号还致命
