composer config -g repo.packagist 配置不生效是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist、第二个参数显式指定 composer 作为 type 值、url 必须是 https 且末尾带 /，缺一则静默回退官方源。
composer config -g repo.packagist 必须写对三个字段
配置不生效不是因为命令没运行，而是键名、type、URL 格式三者缺一不可。漏掉任意一个，composer install 就会静默 fallback 到 packagist.org，卡在 Resolving packages...。
-
repo.packagist是唯一合法键名（注意是单数repo，不是repos或packagist.org） - 第二个参数必须显式传
composer，它是type值，不是注释，不能省略或替换成package等其他字符串 - URL 必须以
https://开头，且结尾带/，例如https://mirrors.aliyun.com/composer/；少斜杠会导致请求/composerpackages.json，404 后直接退回到官方源
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果只返回 URL 字符串、空、null，说明配置失败。
Alpine 镜像里 HTTPS 请求失败要补 ca-certificates 和 curl
即使镜像源配置完全正确，composer install 在 php:alpine 类镜像中仍可能报 SSL certificate problem —— Alpine 默认不带 CA 证书，也不一定装了 curl，而 composer config 在某些版本下依赖 curl 发起 HTTPS 请求。
- 必须加
RUN apk add --no-cache ca-certificates - 建议同时加
RUN apk add --no-cache curl，避免composer config静默失败（尤其在composer:2等精简镜像中） - 别用已停用的旧地址，如
https://packagist.phpcomposer.com，换成当前可用的https://mirrors.aliyun.com/composer/
多阶段构建中 final 阶段读不到 root 的全局配置
builder 阶段执行了 composer config -g，但 final 阶段运行 composer dump-autoload 又连回 packagist.org，大概率是因为用户切换了。
-
composer config -g写入的是/root/.composer/config.json，而 final 阶段若以www-data或其他非 root 用户运行，它读不到该文件 - 解决方法是切换用户执行配置：例如
RUN su www-data -c "composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/" - 或者统一用户：在 Dockerfile 开头加
USER www-data，再执行所有composer相关命令
Dockerfile 中安装 Composer 二进制并确保 PATH 可用
官方 PHP 镜像（如 php:8.2-cli）默认不带 composer 命令，装了但找不到，本质是路径或权限问题。
- 推荐用
COPY --from=composer/composer:2-bin /composer /usr/local/bin/composer，比curl | php更稳定、版本可控 - 确认
/usr/local/bin在$PATH中（绝大多数基础镜像已包含，但自定义 Alpine 镜像需检查） - 避免在
COPY composer.json composer.lock ./之前执行composer config，否则项目级repositories字段会覆盖全局配置 - 构建时若用了
--no-cache，要确认配置命令没被缓存层跳过
最常被忽略的一点：配置生效的前提是 Composer 能真正发起 HTTPS 请求并解析响应。哪怕 composer config -g 显示成功，只要后续 install 阶段证书校验失败或 URL 路径 404，就会无声退回到官方源——得看网络请求日志，不能只信配置输出。
