Composer断网安装失败后自动回滚composer.json是保护机制，非故障；真正需解决的是网络连通性、PHP扩展（如openssl）启用状态及镜像配置有效性，并提前在联网机预拉取缓存或打包vendor+lock离线部署。
Composer断网安装失败后自动回滚 composer.json，不是故障，是保护机制；真正要解决的，是“为什么断网”以及“如何让下次不卡在半路”。
断网失败时 Composer 实际做了什么
当 composer require 或 composer install 因网络中断失败，Composer 会：
- 检测到下载、解析或提取任一环节返回非 0 状态（如
cURL error 7、failed to open stream） - 立即中止整个流程，不写入
vendor/，也不修改composer.lock - 把
composer.json文件内容还原为执行前的 SHA256 值——这就是你看到的 “reverting ./composer.json”
注意：这个回滚只改 composer.json，不会动 composer.lock 或 vendor/。如果你之前删过 composer.lock，它也不会帮你恢复。
断网类错误最该先查的三件事
别急着重试，先确认是不是真“断网”，还是被系统级策略拦住：
- 运行
curl -I https://mirrors.aliyun.com/composer/packages.json，看是否返回HTTP/2 200；如果卡在* Connected to或报Connection refused，说明 DNS 或出口代理不通 - 检查
composer config -g repos.packagist输出是否为你配置的镜像地址；若为空或仍是https://packagist.org，说明镜像没生效（常见于拼错字段名：repo.packagist缺s） - 执行
php -m | grep openssl，无输出代表 OpenSSL 扩展未启用——此时所有 HTTPS 请求都会静默失败，连错误都不报
断网后重试前必须清理的缓存项
Composer 在断网失败后可能已缓存了损坏的 ZIP 包，不清掉会反复复用失败文件：
- 运行
composer clear-cache，清空~/.composer/cache/files/下全部 ZIP 和 JSON - 如果刚手动删过
vendor/，但没删composer.lock，请一并删除它——否则composer install仍会尝试从缓存解压旧包，不发新请求 - 加
--no-cache参数强制跳过缓存：composer install --no-cache，避免读取残留损坏文件
只清缓存、不清 composer.lock，和只删 vendor/、不删 composer.lock，效果几乎一样：Composer 还是按旧契约走，失败概率不变。
离线环境想装包？别依赖回滚，得提前准备
“断网安装失败”听起来被动，但真要应对离线场景，不能靠出错再补救：
- 本地联网时，用
composer install --prefer-dist --no-scripts --no-plugins完整拉取所有包 ZIP 到缓存，再打包~/.composer/cache/files/目录带走 - 目标机器上先执行
composer config --global cache-dir /path/to/copied/cache，指向离线缓存目录 - 确保
composer.json中不含repositories字段（会强制联网校验），且所有包版本已在composer.lock中锁定
回滚本身不可怕，可怕的是把回滚当成兜底方案——它不修复任何问题，只防止更糟。网络层没通、扩展没开、镜像没配对，重试十次结果一样。
