composer install --no-dev --optimize-autoloader 不是独立可靠的生产部署命令，必须组合 --classmap-authoritative、清理 vendor、校验 lock 文件一致性，并在目标环境执行以确保类加载正确与依赖一致。
Composer 本身不提供分布式部署能力，所谓“分布式部署依赖解决方案”，本质是用它管理好各节点的依赖一致性，再配合外部工具完成分发。直接在 composer.json 里写个脚本就想把代码推到十台边缘服务器上，行不通。
composer install --no-dev --optimize-autoloader 在边缘节点失效的常见原因
很多团队在边缘节点执行 composer install --no-dev --optimize-autoloader 后发现类加载变慢、甚至报 Class not found，根本不是命令错了，而是没关掉自动发现机制：
- 默认启用
classmap-authoritative时，Composer 只从 classmap 加载类，忽略 PSR-4 自动映射 —— 但如果你的包没走dump-autoload预生成 classmap，或用了动态注册（如 Laravel 的 service provider 中 require_once），就会漏类 - 边缘节点若用的是 symlink 安装（
preferred-install: source），而目标环境没开follow_symlinks，--optimize-autoloader会跳过 symlink 目录，导致 classmap 不全 - 某些私有包仓库返回的
dist包不含autoload.files声明，但实际需要手动引入 ——--optimize-autoloader不处理这类文件，运行时就崩
多节点同步时 composer.lock 文件必须严格一致
边缘节点之间如果只同步代码、不校验 composer.lock，极易出现“同一份代码，在 A 节点正常、B 节点报错”的问题。这不是 Composer bug，而是 lock 文件未被纳入部署流水线：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install的行为完全由composer.lock决定，哪怕composer.json没变，只要 lock 文件里某包的 commit hash 或 dist url 不同，安装结果就可能不同 - CI 构建时若用
composer update生成新 lock，但没提交回 Git，下游边缘节点拉的还是旧 lock —— 此时composer install实际安装的是旧版本依赖 - 跨区域镜像同步时，Satis 生成的静态仓库若没强制 rehash 所有 dist 包，不同边缘节点可能从不同镜像源拉到相同版本号但不同 checksum 的 zip 包，触发 Composer 的完整性校验失败
Docker 多阶段构建中漏掉 --classmap-authoritative 的后果
在 Dockerfile 里写 RUN composer install --no-dev --optimize-autoloader 是常见操作，但少加 --classmap-authoritative 会导致容器启动后首次请求极慢，甚至超时：
- 没有
--classmap-authoritative，Composer 仍会扫描 PSR-4 路径做 fallback 查找 —— 这在容器内大量小文件的 layer 上尤其低效 - PHP OPcache 若启用了
opcache.validate_timestamps=1（开发默认），每次请求都重新 stat 所有 PSR-4 目录，CPU 和 I/O 爆涨 - 该参数必须和
--optimize-autoloader同时使用才生效；单独加没用，单独不加则优化不彻底 - 推荐写法：
RUN composer install --no-dev --optimize-autoloader --classmap-authoritative
真正麻烦的不是命令怎么写，而是谁来保证所有边缘节点跑的都是同一个 composer.lock、同一个镜像 tag、同一个 PHP 扩展集。这些一致性边界，Composer 不管，得靠 CI 流水线卡死。一旦漏掉一个环节，问题就藏在“看起来一样”的表象下面，很难复现。
