项目级repositories字段会完全覆盖全局镜像配置，导致composer update仍走官方源；元数据缓存默认15分钟不过期，需用--refresh（≥2.5）或手动删缓存目录强制更新。
镜像源配置被项目级 repositories 覆盖
你明明运行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，但 composer update 还是慢得像在连海外源——大概率是项目根目录的 composer.json 里写了 "repositories" 字段。只要它存在，哪怕内容是 {"packagist.org": false} 或空对象，Composer 就会彻底忽略全局镜像。
检查方式：
- 运行 composer config --list | grep repositories，看输出的 repositories.packagist.url 是否为你设的阿里云地址
- 打开项目 composer.json，搜索 "repositories" —— 存在就删掉整段（注意保留缩进格式）
- 临时验证：执行 composer config --unset repositories（不加 -g），再试 composer update
元数据缓存过期导致“更新无效”
composer update 显示 0 installs, 0 updates，不是没新版本，而是 Composer 复用了本地缓存的 packages.json（默认 15 分钟不过期）。它根本不去镜像站拉最新元数据，所以新发布的包永远“看不见”。
解决方法取决于 Composer 版本：
- ≥ 2.5：直接用 composer update --refresh，强制丢弃所有缓存的元数据，只从当前生效镜像重拉
- ≤ 2.4：手动清理对应缓存路径：rm -rf $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer
- composer clear-cache 没用——它只清 ZIP 和 provider 缓存，不碰元数据
self-update 不走镜像源，换源无效
很多人以为改了 repo.packagist 就能加速 composer self-update，其实完全无关。self-update 只连 https://getcomposer.org/ 的 Releases API，不读任何镜像配置。国内网络常拦截这个地址，导致卡在 Could not fetch packages。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 先确认安装路径：which composer，再查权限：ls -l $(which composer)
- 若是 apt/brew 安装的（路径含 /usr/bin/ 或 /opt/homebrew/bin/），别用 sudo composer self-update，改用包管理器升级：sudo apt install --only-upgrade composer 或 brew upgrade composer
- 若需最新版且不想等同步，删旧版重装：sudo rm $(which composer) → php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" → sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
PHP 环境限制或插件不兼容
宝塔面板里执行 composer self-update 报 putenv() has been disabled，或 composer update 卡在 Package operations: 0 installs, 0 updates 不报错——不是网络问题，是 PHP 禁用了必需函数，或旧插件不支持新 API。
关键点：
- 宝塔 PHP 管理中禁用了 putenv、proc_open？绕过方式：/www/server/php/82/bin/php -d "disable_functions=" /usr/local/bin/composer self-update（把 82 换成你实际用的 PHP 版本号）
- 插件如 hirak/prestissimo 已归档，不支持 Composer 2.5+ 的 plugin API v2.0，结果就是命令挂起无响应。验证方式：composer install -n 能跑通，说明是插件问题；删掉 composer.json 中的 "plugins" 字段，或执行 composer config --global --unset plugins
- PHP 版本低于 8.0 却升到 Composer 2.5+，表面成功，首次运行就 Fatal error: Attribute —— 升级前必须确认 php -v
真正卡住人的地方，往往不是网络或权限本身，而是 Composer 的三重隐性控制链：PHP 版本 → 插件 API 兼容性 → 镜像源与元数据缓存的耦合关系。任何一个环节断掉，它都倾向于静默跳过，而不是报错提示。
