根本原因是宝塔以www用户执行composer install，而root配置的镜像仅存于/root/.composer/config.json，www用户无法读取；必须用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/重配，或写入系统级配置/etc/composer/config.json，并清除缓存、开放putenv/proc_open/pcntl_signal禁用函数。
宝塔后台执行 composer install 为什么卡在 Loading composer repositories
根本原因不是网络慢，而是 PHP 进程根本没读到你配的镜像地址。宝塔所有网站 PHP 任务（包括「一键部署」「其他设置→Composer 执行安装」）默认以 www 用户运行，而你用 root 身份执行的 composer config -g 只写进了 /root/.composer/config.json，www 用户压根看不到。
验证方法：
在宝塔终端里执行 sudo -u www composer config -g repo.packagist，如果输出是空或 null，说明镜像配置对后台任务完全无效。
- 必须用
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/重配（注意三要素：-g、repo.packagist、composer、末尾斜杠不能少） - 或者更彻底：直接写系统级配置
/etc/composer/config.json，所有用户（含www）都会加载 -
composer clear-cache必须执行，否则 Composer 仍按旧缓存发请求
执行时提示 putenv() has been disabled 或 proc_open(): fork failed
这不是 Composer 镜像的问题，是宝塔 PHP 管理里禁用了关键函数，导致 Composer 启动阶段就崩溃。即使镜像 URL 正确、用户也对了，照样卡死或报错。
重点：宝塔的「禁用函数」列表里，putenv、proc_open、pcntl_signal 这三个必须全部删除——少一个都可能在不同阶段失败。
- 进【网站】→【PHP 管理】→ 选中你项目所用的 PHP 版本 →【禁用函数】→ 手动删掉这三项文字（不是取消勾选），然后点【重载配置】
- 特别注意：
php-cli.ini和php.ini是两个文件，命令行执行 Composer 用的是php-cli.ini，别只改了php.ini - 多 PHP 版本共存时，每个版本都要检查并清理禁用函数
明明装了 fileinfo/zip 扩展，却报 missing extension
宝塔后台执行 Composer 时用的 PHP CLI 环境，和网站 FPM 环境不是同一个上下文。你在面板里给某个 PHP 版本装了扩展，只是加到了 FPM 的 php.ini，CLI 模式下未必生效。
- 进宝塔【软件商店】→ 找到对应 PHP 版本 →【设置】→【安装扩展】→ 勾选
fileinfo和zip，确认安装完成 - 再执行
sudo -u www /www/server/php/83/bin/php -m | grep -E 'fileinfo|zip'（把83换成你实际版本号），确认 CLI 下确实加载了 - 如果没显示，手动编辑
/www/server/php/83/etc/php-cli.ini，确保里面有extension=fileinfo.so和extension=zip.so
执行命令后 vendor/autoload.php 找不到，但日志显示成功
常见于用宝塔「其他设置→Composer 执行安装」时，它默认在网站根目录运行，但如果你的 composer.json 不在根目录（比如在 app/ 或 src/ 子目录），就会静默失败，或者生成到错误路径。
- 先确认
composer.json的位置：进宝塔文件管理器，看它是否真在网站根目录（如/www/wwwroot/example.com/composer.json） - 如果不是，要么把文件移过去，要么改用终端手动执行：
sudo -u www /www/server/php/83/bin/php /usr/local/bin/composer install --working-dir=/www/wwwroot/example.com/app - 权限问题也会导致生成失败：确保
www用户对vendor/目录有写权限，可临时执行sudo chown -R www:www /www/wwwroot/example.com/vendor
最易被忽略的一点：宝塔后台执行 Composer 时，不会自动加载你本地终端里设的 PATH 或 alias，它只认绝对路径。所以哪怕你 composer -V 在终端能跑，后台任务也可能找不到命令——务必用 /usr/local/bin/composer 或 /www/server/php/83/bin/composer 这类完整路径调用。
