物理服务器迁移时Composer镜像源不会自动同步，因~/.composer/config.json为用户级文件且不随系统镜像迁移，新环境若未显式配置将静默fallback至packagist.org；必须复制整个.composer/目录（含cache/）、验证composer config -g repo.packagist输出为完整JSON、清除旧缓存路径并强制重拉元数据。
物理服务器迁移时，Composer 镜像源不会自动同步——~/.composer/config.json 是用户级文件，不随系统镜像或 rsync 自动迁移，且新环境若未显式配置，会立即 fallback 到 https://packagist.org，导致首次 composer install 卡住或超时。
确认旧服务器上真实生效的镜像配置
别只信“我之前配过”，要查实际写入值。运行：
composer config -g repo.packagist
输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON；如果为空、报错、或仍是官方地址，说明配置根本没生效。常见静默失败原因：
-
repo.packagist误写成repos.packagist（多一个 s） - 命令漏了
-g，只改了当前项目目录下的composer.json - URL 缺少末尾
/，如https://mirrors.aliyun.com/composer→ 请求会变成/composerpackages.json，直接 404 - 没指定
composer类型值：composer config -g repo.packagist composer https://...中中间的composer不可省略
迁移时必须复制的文件与路径
全局镜像配置存在 ~/.composer/config.json，但该路径依赖当前用户主目录。迁移时需明确操作：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
composer config --global config-dir查出真实路径（Linux/macOS 通常是$HOME/.composer，Windows 是%APPDATA%\Composer） - 完整复制整个
.composer/目录（含cache/子目录），不只是config.json—— 因为cache/repo/下已缓存的元数据（如packages.json）能避免迁移后首次请求重拉全量索引 - 若新服务器用不同用户（如从
root迁到www-data），不能只复制文件，必须用对应用户执行composer config -g重设，否则权限或路径错位会导致静默失效
新服务器上线前的强制验证步骤
配置复制完不等于可用。必须在新机器上逐项验证：
- 运行
composer config -g repo.packagist，确认输出是你期望的镜像地址 - 用
curl -I https://mirrors.aliyun.com/composer/packages.json检查 HTTP 状态码是否为HTTP/2 200（不是 301 或 404） - 执行
composer show -p | head -3，观察是否秒出结果；若卡顿 >5 秒，说明仍连着官方源或 DNS 解析异常 - 检查项目级
composer.json是否含"repositories"字段——若有，它会完全屏蔽全局配置，此时需删掉或改用数组格式并首项写{"packagist.org": false}
为什么不能只靠 composer clear-cache
composer clear-cache 只清 ZIP 包和部分 provider 缓存，对决定“有没有这个包”的核心元数据文件（packages.json、provider-*.json）几乎无效。这些文件实际存在 $(composer config --global cache-dir)/repo/https---mirrors-aliyun-com-composer/ 这类转义路径下。迁移后若发现 composer install 报 Package not found，大概率是缓存路径里还残留着旧的 https---packagist.org 子目录，而新配置指向的镜像子目录为空。此时最稳做法是：
- 先确认缓存位置：
composer config --global cache-dir - 进
repo/子目录，手动删掉所有非目标镜像的目录（如https---packagist.org） - 再运行
composer update --refresh（≥2.5），强制从阿里云镜像重拉最新元数据，跳过本地缓存判断
迁移的本质不是“复制配置”，而是确保新环境的元数据获取链路（配置 → 缓存路径 → 实际请求 URL）三者严格对齐；任何一环错位，都会让 Composer 在无人察觉时悄悄切回官方源。
