composer报错“file could not be downloaded”或“protocol https not supported”的根本原因是php缺少openssl扩展或composer配置中错误启用了disable-tls true，导致https被禁用；需检查php.ini中extension=openssl是否启用，并执行composer config -g --unset disable-tls，同时确保镜像源配置正确：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（url必须以/结尾）。
composer install 报错 “file could not be downloaded” 或 “protocol https not supported” 怎么办
这不是网络不通，而是 Composer 试图用 HTTP 协议下载包，但当前版本（2.x+）默认禁用非 HTTPS 源；根本原因通常是镜像源配置错误或残留了 disable-tls true 这类危险设置。
常见错误现象包括：
file could not be downloaded: https://... failed to open stream: Unable to find the wrapper "https"protocol https not supported or disabled in libcurl- 即使换了镜像 URL，
composer install仍卡在 downloading 阶段，且日志里反复出现http://请求
核心问题就两点：PHP 缺少 openssl 扩展，或 Composer 配置里强行关掉了 TLS。先检查 PHP 环境：
- 运行
php -m | grep openssl，没输出说明扩展没启用 - 确认
extension=openssl在php.ini中已取消注释，且重启了 Web 服务或 CLI 环境
再查 Composer 配置是否主动破坏了 HTTPS：
- 执行
composer config -g disable-tls，如果输出true，立刻删掉：composer config -g --unset disable-tls - 这个配置一旦存在，所有源（包括阿里云、腾讯云）都会被降级成 HTTP，然后直接失败
composer config -g repo.packagist 命令总报错或无效
命令执行后 composer config -g repo.packagist 输出空、null 或仍是 https://packagist.org，说明根本没写进去——不是网络问题，是键名、参数或路径错了。
必须同时满足这四点才真正生效：
- 加
-g参数，否则只改当前项目composer.json，切目录就失效 - 键名必须是
repo.packagist（单数、全小写、无s），写成repos.packagist或repositories都静默失败 - 命令末尾必须显式带上
composer—— 这是type值，不是注释：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须以
/结尾，否则 Composer 2.5+ 会拼出.../composerpackages.json导致 404
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
换源后 composer install 还卡在 Loading composer repositories
这是镜像源根本没生效的铁证。Loading 阶段是去远程拉取 packages.json 元数据，卡在这里 = 还在连 packagist.org。
除了上面的配置检查，还要注意两个隐藏干扰项：
- 项目根目录
composer.json里有"repositories"字段（哪怕只是空数组[]），它会完全屏蔽全局repo.packagist配置 - Windows 下用 Git Bash 时，
COMPOSER_HOME环境变量可能未生效，实际读的是%APPDATA%\Composer\config.json，而不是~/.composer/config.json
临时绕过项目级覆盖的方法：
- 用
--repository参数强制指定一次：composer install --repository=https://mirrors.aliyun.com/composer/ - 或者删掉项目里的
repositories块：sed -i '/"repositories":/,/],/d' composer.json（Linux/macOS）
换源后 vendor/autoload.php 存在但 Class not found
这不是 autoload 机制坏了，而是依赖压根没装全——镜像源同步延迟、配置错误导致 composer install 实际只下了部分包，vendor/autoload.php 文件存在，但里面没注册对应类。
别急着删 vendor 重来，先做三件事：
- 执行
composer clear-cache，否则旧元数据还在本地，换源也白搭 - 确认镜像是否已同步新包：打开
https://mirrors.aliyun.com/composer/packagist/搜你要的包名 - 运行
composer dump-autoload -o，如果报错说某个类在autoload_classmap.php里找不到，基本确定是安装不完整
阿里云镜像通常延迟 5–10 分钟，腾讯云同步更快；如果装的是刚发布的包，换源后等几分钟再试，比反复重装更省时间。
