配置失败而非不生效，因composer 2.2+要求repo.packagist（单数键名）、type值显式为composer、url必须https且末尾带/，三者缺一即未写入；验证需输出完整json对象。
composer config -g repo.packagist 输出不是完整 JSON
这说明配置根本没写进去，不是“不生效”，而是压根失败了。Composer 2.2+ 对 repo.packagist 的键名、type 值、URL 格式三者缺一不可：
- 键名必须是
repo.packagist（单数，不是repos.packagist或packagist.org） - 第二个参数必须显式传
composer，它是type字段值，不是可选注释 - URL 必须以
https://开头，且结尾必须有/，例如https://mirrors.cloud.tencent.com/composer/
错误示例：composer config -g repo.packagist https://mirrors.aliyun.com/composer（缺 composer 和结尾 /）
正确写法：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
验证命令仍是 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"} 的完整 JSON 对象；只返回字符串、null 或空行，都代表失败。
Docker 多阶段构建中 final 阶段镜像源失效
builder 阶段配好了 repo.packagist，但 final 阶段运行 composer install 仍连 packagist.org，大概率是用户权限错位：
-
composer config -g写入的是/root/.composer/config.json，而 final 阶段若以www-data或其他非 root 用户运行，它读不到 root 的全局配置 - Alpine 镜像默认不带 CA 证书，
RUN apk add --no-cache ca-certificates必须存在，否则 HTTPS 请求直接失败 - 部分精简镜像（如
composer:2）还缺curl，导致composer config静默失败，建议补上：RUN apk add --no-cache curl
解决方法：在 final 阶段用目标用户执行配置，例如：RUN su www-data -c "composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/"
更稳妥的做法是项目级配置：RUN composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/，它会写进当前目录的 composer.json，不受用户影响。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
HTTPS 证书校验失败导致 fallback 到官方源
即使 composer config -g repo.packagist 输出正确，composer install 仍卡在 Resolving packages 或报 SSL certificate problem，问题不在 Composer 配置本身，而在底层证书链：
- PHP CLI 使用的
openssl.cafile或curl.cainfo指向了空文件、过期文件或根本未设置 - Linux 容器中（尤其是 Alpine）未安装
ca-certificates包，php -r "print_r(openssl_get_cert_locations());"会显示default_cert_file为空或路径不存在 - 系统时间偏差过大，导致服务器证书被判定为“未生效”或“已过期”
临时验证方式：curl -I https://mirrors.cloud.tencent.com/composer/packages.json —— 若同样失败，说明是系统/PHP 层面的证书问题，不是 Composer 配置问题。
不要用 COMPOSER_NO_SSL=1 或 --no-secure-http 掩盖问题；生产环境应更新 CA 证书包，并在 php.ini 中显式设置 curl.cainfo = "/etc/ssl/certs/ca-certificates.crt"（路径依系统而定）。
镜像源地址已停用或同步异常引发 hash verification failed
hash verification failed 错误表面是文件校验失败，根源常是镜像源内容损坏或不同步：
-
https://packagist.phpcomposer.com已停用多年，仍在用等于主动触发失败 - 阿里云旧地址
https://mirrors.aliyun.com/composer/自 2026 年起同步稳定性下降，推荐切换至腾讯云镜像https://mirrors.cloud.tencent.com/composer/ - 缓存损坏也会复现该错误，先运行
composer clear-cache，再换源重试
最干净的验证方式：临时切回官方源测试：composer config -g repo.packagist composer https://packagist.org，如果此时能成功安装，基本锁定是第三方镜像问题。
别跳过 composer config -g repo.packagist 的输出验证——哪怕命令没报错，输出不对就等于白配。
