灰度发布时不能等上线再执行composer install，因其就地覆盖vendor会导致半更新状态、autoload.php缺失或不完整，引发class not found错误；必须预下载依赖、走--prefer-dist缓存复用，并确保构建机与灰度机composer版本及缓存路径一致。
灰度发布时依赖包没提前下载好，线上切流瞬间就报 Class not found 或 failed to open stream——这不是代码问题，是 composer install 在就地覆盖 vendor/ 时卡在半中间导致的原子性失败。
为什么灰度环境不能等上线时再 composer install
灰度流量进来前，vendor/ 必须已就位且完整。一旦用 composer install 直接操作线上目录：
- 网络抖动或镜像源超时会导致部分包解压失败，
vendor/autoload.php可能缺失或不完整 -
composer.lock已写入新哈希，但vendor/里只有 70% 的包，PHP 自动加载器直接崩溃 - 没有原子切换机制，无法回滚，只能人工紧急重启或切回旧版本
预下载必须走 --prefer-dist + 缓存复用
离线或灰度部署不是“不联网”，而是“不依赖实时网络”。关键在于让所有包提前进缓存，并确保安装时只读缓存：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在构建机（有网）执行：
composer install --no-scripts --no-plugins --prefer-dist --no-dev - 确认缓存已生效：日志中出现
Loading from cache，而非Downloading - 拷贝整个
COMPOSER_HOME/cache/目录（路径可用composer config --global cache-dir查） - 灰度机器上先设环境变量：
export COMPOSER_CACHE_DIR=/path/to/copied/cache - 再运行：
composer install --no-interaction --prefer-dist
注意：--prefer-dist 是硬性要求——如果 composer.lock 里某包类型是 source（比如你本地开发时用了 --prefer-source），缓存里就没有 zip 包，离线时会直接失败。
灰度分支的 composer.json 和 composer.lock 必须独立管理
主干锁死 "monolog/monolog": "2.8.0"，灰度分支想试 2.9.x，不能只改 composer.json 然后跑 composer update 就完事：
- 灰度分支必须提交自己专属的
composer.lock，且该文件要包含所有依赖的dist类型和校验值 - CI 构建灰度镜像时，必须用
--no-dev和--no-interaction，防止require-dev干扰或交互式提示中断流程 - 别信
config.platform能模拟 PHP 版本就万事大吉——它只影响版本兼容判断，不改变实际下载行为
真正容易被忽略的是缓存路径和 Composer 版本一致性：离线机上的 composer --version 必须和构建机一致，否则缓存格式不兼容，Loading from cache 会静默 fallback 到网络下载。
