K8s中composer config -g无效，因Pod无持久化家目录；唯一可靠方式是在Dockerfile构建阶段固化镜像源，需满足repo.packagist拼写正确、type为composer、URL末尾带/。
composer config -g 在 K8s Pod 里根本不会生效
因为 Pod 启动时没有持久化的用户家目录，composer config -g 写入的 ~/.composer/config.json 在容器重启后就丢失了。哪怕你在构建镜像时跑过这条命令，只要没写进镜像层（比如用了非 root 用户或没指定 HOME），运行时 composer install 仍会 fallback 到 https://packagist.org。
常见现象包括：Loading composer repositories with package information 卡住、日志反复出现 Could not fetch packages.json、超时失败。
- 别在
entrypoint.sh或initContainer里执行composer config -g——它只影响当前 shell 进程，不写入文件系统 - 别挂载宿主机的
/root/.composer进容器——UID 不匹配、路径不可见、权限拒绝 - CI 流水线中缓存了
vendor/但没缓存~/.composer，也会导致镜像配置失效
必须在 Dockerfile 构建阶段固化镜像源
唯一可靠的方式，是把镜像源写进镜像文件系统本身，且必须满足三个硬性条件：
-
repo.packagist拼写不能错（不是repos.packagist） -
composer作为type值不可省略（不是注释，是必需字段） - URL 末尾必须带
/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会导致请求路径拼成/composerpackages.json直接 404
验证是否成功：在 RUN 后加一句 RUN composer config -g repo.packagist，构建日志应输出 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
推荐写法（多阶段构建中）：
FROM composer/composer:2-bin AS composer
WORKDIR /app
COPY composer.json composer.lock ./
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ && \
composer install --no-dev --no-scripts --optimize-autoloader
项目级配置比全局更稳定，尤其在多租户 K8s 环境
如果你的集群跑多个 PHP 应用，且它们依赖不同私有源，全局配置反而会干扰 repositories 合并逻辑。此时应优先改 composer.json：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在根节点显式禁用官方源：
"packagist.org": false（注意：不是放在repositories里） - 在
repositories数组首位添加镜像条目：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 确保
repositories是数组，不是对象（错误写法："repositories": {"packagist": {}}） - 改完后必须手动删掉
vendor/和composer.lock，再跑composer install；update无效，它照着旧 lock 文件里的 dist URL 下载
这样 Git 可追踪、CI 可复现、新人拉代码即生效，且优先级高于全局配置。
跨区域 K8s 集群里镜像源失效的真正原因
你以为是网络慢？其实是配置没穿透到所有 Pod 进程。即使你在 master 节点上配过 composer config -g，那也只是写进了 /root/.composer/config.json，而 Pod 容器启动时是干净环境，HOME 是 / 或 /app，压根不查那个路径。
验证方式：进 Pod 执行 composer config -g repo.packagist，输出为空或仍是 {"type":"composer","url":"https://packagist.org/"} 就说明没生效。
绕过用户级配置不确定性的办法：
- Dockerfile 中不用
config -g，改用临时参数：composer install --repository=https://mirrors.aliyun.com/composer/ --no-interaction - CI/CD 中统一注入环境变量：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 避免在
Dockerfile中用USER www等非 root 用户执行config -g——写入的是该用户的家目录，而 php-fpm 进程可能以不同用户身份运行
最易被忽略的一点：镜像源只加速包文件下载（.zip/.tar），不参与依赖解析。如果 composer install 卡在 Resolving dependencies，问题和镜像无关，得去检查 composer.json 里的版本约束是否过于宽泛。
