Composer install有vendor和lock仍报错,是因为默认强制联网校验packages.json;必须设COMPOSER_DISABLE_NETWORK=1才真正离线,否则--no-xxx参数无效。

为什么composer install在有vendor/和composer.lock时仍报错?
不是缓存没生效,是 Composer 默认行为根本没打算离线——它会在 install 阶段强制请求 https://repo.packagist.org/packages.json 校验元数据。哪怕 vendor 目录完整、lock 文件也没改过,只要没显式切断网络通路,就一定会失败。
关键点:COMPOSER_DISABLE_NETWORK=1 是硬性开关,不设它,所有 --no-xxx 参数都无效。这个变量必须在运行 composer install 前就生效,且对整个进程链有效。
- Linux/macOS:用
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader - Windows PowerShell:
$env:COMPOSER_DISABLE_NETWORK="1"; composer install --no-plugins --no-scripts --no-autoloader - Windows CMD:
set COMPOSER_DISABLE_NETWORK=1 && composer install --no-plugins --no-scripts --no-autoloader
composer.json里加了"repositories"还连网?怎么彻底关掉 Packagist
只在项目级 composer.json 里写 "repositories": [{"type":"path","url":"./packages"}] 不够。Composer 会先查默认源(Packagist),再 fallback 到你配的本地源——而 fallback 前那一步已经触发了网络请求。
必须从全局和项目两个层面同时禁用:
- 运行
composer config --global repo.packagist false(全局关掉) - 检查项目内是否残留
"repositories": [{"type":"composer","url":"https://packagist.org"}],删掉它 - 确认
composer config --list | grep repo.packagist输出为repo.packagist (null)或直接不显示
如果 composer install -v 还能看到 Downloading https://repo.packagist.org/packages.json,说明某处配置没生效,不是路径问题,是开关没关死。
离线模式下vendor/能直接复制吗?要注意什么?
可以,而且是最简单有效的做法——但前提是源和目标环境一致:
- PHP 版本必须相同(如都是 8.3),否则某些包(如
ext-redis绑定的类)可能无法加载 - 必需扩展要齐全(
mbstring、openssl、json等),缺一个,vendor/autoload.php可能 require 失败 -
composer.lock必须一并拷过去,且不能被修改;否则composer install会尝试重算依赖树 - 目标机执行前清空旧
vendor/,避免 autoload 冲突(比如旧包里有同名 class,但文件已删)
验证方式:在目标机跑 php -r "require 'vendor/autoload.php'; echo 'OK';",能输出 OK 才算真正可用。
为什么composer dump-autoload -o不能省?
--no-autoloader 是跳过 install 阶段的 autoload 重建,不是永久禁用 autoload。它只是防止 install 过程中因路径或权限问题导致失败,但不会生成优化后的 vendor/composer/autoload_classmap.php。
离线环境下没有 classmap 文件,运行时只能靠扫描文件找 class,而扫描逻辑依赖 vendor/composer/autoload_psr4.php 等——这些文件在 --no-autoloader 下不会更新,容易漏类。
- 执行
composer dump-autoload -o后,vendor/composer/autoload_classmap.php会被生成,所有类名直连路径,不依赖文件系统遍历 - 若项目用了
"classmap": ["app/"],这步更是必须,否则app/下的类大概率找不到 - 别用
-a(--optimize)以外的参数,-o(--classmap-authoritative)才是离线稳定的关键
最容易被忽略的是:这步必须在 composer install --no-autoloader 之后立刻执行,且不能跳过。否则上线第一请求就 Class not found。


















