私有化部署失败主因是镜像配置未随制品交付：全局配置仅对当前用户生效，项目级配置无法覆盖依赖包内声明的源，且内网环境存在HTTPS重定向、防火墙等信任链问题。
私有化部署失败，70%卡在 composer install 阶段——不是代码问题，是镜像配置没随制品一起交付。
为什么不能只教客户配镜像？
客户现场常以非 root 用户（如 www、runner）运行部署脚本，而你用 sudo composer config -g 写进 /root/.composer/config.json，实际进程根本读不到。更隐蔽的是：composer config -g repo.packagist 拼错成 repos.packagist，命令不报错但字段无效，查出来为空，没人发现。
- 全局配置只对当前用户生效，CI 构建机、宝塔后台、Docker 容器内用户各不相同
- 项目级
composer.json中的repositories仅影响本项目，无法覆盖依赖包内部声明的源（比如某私有包自己写了"repositories": [{"type":"composer","url":"https://repo.packagist.org"}]） - 客户内网环境可能禁用 HTTPS 重定向、拦截
file_get_contents、或防火墙丢弃 443 外部请求——这些都不是“配错”，而是信任链断裂
怎么把镜像配置真正“打包进去”？
核心原则：配置必须和应用代码同路径、同用户、同生命周期。推荐直接改项目根目录下的 composer.json，用 composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 命令追加，而不是手写 JSON。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 该命令会自动 merge 到
repositories字段，兼容已有私有源；若原repositories是数组（[]），需先手动改成对象（{}）再执行 - 别写
"packagist.org": false，这会彻底关掉官方源，一旦镜像临时不可用，composer install直接失败 - 改完必须删掉
vendor/和composer.lock，否则旧 lock 文件里的哈希仍指向原源，拉取时校验失败 - 如果部署包里已含
vendor/，说明镜像配置未生效过，属于“伪打包”，要回溯构建流程
内网离线场景下怎么验证镜像 URL 是否可用？
别等 composer install 卡在 Resolving dependencies 才排查——那是它在死磕 https://repo.packagist.org/packages.json，根本没走你配的镜像。
- 先运行
composer config -g repo.packagist，输出必须是{"type": "composer", "url": "https://your-mirror.com/"}，末尾带/ - 用
curl -I https://your-mirror.com/packages.json看响应头：Content-Type: application/json必须存在，否则 Composer 静默跳过 - URL 少一个斜杠（如
https://mirror.internal），Composer 会拼成https://mirror.internalpackages.json→ 404；正确写法是https://mirror.internal/ - 如果是
file:///方案，必须用三个斜杠（file:///data/packagist/），且确保运行用户有读权限
CI/CD 流水线里如何避免缓存污染？
GitHub Actions 或 GitLab CI 常复用 ~/.composer/cache，但不同镜像源生成的缓存内容不兼容，混用会导致 corrupted cache file 或安装失败。
- 缓存 key 必须显式包含镜像标识，例如：
composer-${{ hashFiles('**/composer.lock') }}-aliyun - 每个 job 开头加校验步骤：
php composer.phar config -g repo.packagist | grep -q "mirrors.aliyun"，失败则 abort - Docker 构建时，不要
COPY . /app后再RUN composer config -g——镜像层固化后，运行时用户可能不是构建用户，配置无效 - 推荐在
Dockerfile中用RUN php composer.phar config -g repo.packagist composer https://mirrors.aliyun.com/composer/，并确认HOME环境变量指向正确路径
最易被忽略的点：Satis 类静态镜像服务，satis build 只生成文件，不提供 HTTP 接口；你得用 Nginx 把输出目录跑起来，且 URL 必须以 / 结尾——少这个斜杠，packages.json 请求就 404，但 Composer 不报错，只默默 fallback 到外网源。
