离线安装失败主因是未设COMPOSER_DISABLE_NETWORK=1,该环境变量为硬性开关,不设则composer install必请求https://repo.packagist.org/packages.json校验元数据,即使vendor和lock完整、断网或加--no-xxx参数均无效。

离线安装失败,90% 是没设 COMPOSER_DISABLE_NETWORK=1,不是 vendor 缺文件、不是 lock 文件坏、也不是镜像没切对。
为什么 composer install 在断网时必报 “Could not fetch”
Composer 默认行为是:不管 vendor/ 是否存在、composer.lock 是否完整,每次 install 都会尝试访问 https://repo.packagist.org/packages.json 校验元数据。这个请求无法跳过,除非硬性切断网络通路。
常见错误现象:
Could not fetch https://repo.packagist.org/packages.json-
Connection refused(即使你加了--no-plugins --no-scripts) Failed to open stream: Connection refused
关键点:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
COMPOSER_DISABLE_NETWORK=1是唯一有效开关,所有--no-xxx参数都依赖它生效 - 不设这个环境变量,
composer diagnose会主动报错,composer install -vvv日志里一定能看到Downloading行 - 全局配置残留(如
composer config --global repo.packagist false)会导致直接退出,而非静默忽略
离线模式下怎么查日志才有效
断网后跑 composer install -vvv 没用——它会在第一行就卡住或报错,根本不会输出完整流程。真正有用的排查动作是“提前验证”和“隔离检查”:
- 先确认是否真断网:
echo "127.0.0.1 packagist.org" | sudo tee -a /etc/hosts,再跑composer install -v;看到Connection refused才算模拟到位 - 验证
composer.lock合法性:php -l composer.lock,语法错误会导致离线 install 直接退出 - 检查
composer.json有没有非法仓库定义:比如"repositories": [{"type": "packagist", "url": false}],这种在COMPOSER_DISABLE_NETWORK=1下会立即报错 - 别信
composer diagnose的输出——它默认检查 HTTP 连通性,离线时必然 FAIL,此时应跳过
COMPOSER_DISABLE_NETWORK=1 生效但还失败?重点查这三处
设了环境变量仍失败,说明问题出在锁文件或运行环境本身,不是网络层:
-
composer.lock里含"source": {"type": "git", "url": "..."}条目:离线时无法 clone,必须删掉或换为dist类型 -
composer.lock中某包的dist.url是https://开头且没配本地仓库:COMPOSER_DISABLE_NETWORK=1下会直接退出,不是跳过 - PHP 环境不一致:源机 PHP 8.2.12 生成的
vendor/,目标机是 8.2.13 或缺mbstring扩展,autoload.php加载就会失败 -
vendor/目录已存在:离线 install 要求 clean slate,否则旧包可能干扰锁文件比对,必须rm -rf vendor/后再跑
最容易被忽略的是 composer.lock 里那些看似无害的 source 字段,以及 PHP 版本微小差异导致的类加载失败——它们不会报网络错误,但会让整个离线流程在最后一步崩掉。

















