根本原因是离线时未生成autoload映射文件；composer install离线跳过包解压与autoloader重建，导致vendor/composer/autoload_*.php为空或缺失，autoload.php加载失败。
composer install 时没联网，autoload.php 为什么报错找不到类？
离线安装后 autoload.php 加载失败，根本原因是 vendor/autoload.php 依赖的自动加载映射（vendor/composer/autoload_classmap.php、autoload_psr4.php 等）压根没生成——因为 composer install 在离线状态下跳过了包解压和 autoloader 重建步骤，哪怕 vendor/ 目录看起来“有东西”。
- 必须确保离线前已执行过完整
composer install（或composer dump-autoload），且vendor/composer/下存在全部autoload_*.php文件 - 离线机器上不能只拷贝
vendor/目录，还要确认vendor/composer/autoload_static.php和installed.php这两个关键文件存在且非空 - 如果用的是
composer install --no-dev，离线环境也得保持一致，否则autoload-dev.php缺失可能间接导致主 autoload 失效（某些包把测试类注册进主映射）
vendor 目录复制后，autoload 仍失效的常见检查点
不是所有“看着像 vendor”的目录都能直接用。Composer 的 autoloader 是静态生成的，路径和哈希都硬编码在生成的 PHP 文件里。
- 检查
vendor/composer/autoload_static.php中的$classMap和$prefixLengthsPsr4是否为空数组——空就意味着没生成映射 - 确认离线机器上的 PHP 版本 ≥ 离线前生成 autoload 的版本（比如 8.1 生成的 static loader 在 7.4 下可能因语法报错）
- 若项目用了
classmap或files类型自动加载，这些路径是相对vendor/autoload.php的，复制后整个vendor/必须保持原层级结构，不能挪动或重命名 -
composer.json中的autoload配置如果有psr-4映射到src/，那src/目录也得一并复制过去，且不能被 .gitignore 误删
如何验证 autoload 是否真就绪？
别等运行时崩了才查，用最简单的 PHP 命令当场测：
php -r "require 'vendor/autoload.php'; var_dump(class_exists('Your\Namespace\ClassName'));"
返回 bool(true) 才算过关。如果报 Class 'X' not found，说明映射没生效；如果报 require(): Failed opening required 'vendor/autoload.php'，那是路径错了；如果报语法错误，大概率是 PHP 版本不兼容或文件损坏。
- 这个命令必须在项目根目录下执行，否则相对路径会断
- 测试类名必须是
composer.json中实际声明过的，不能随便写个不存在的类来“碰运气” - 如果项目用了
apcu或opcache，记得清掉缓存再测，否则可能看到旧的失败结果
为什么用 composer dump-autoload --optimize 不总管用？
--optimize 会合并映射为单个 autoload_static.php，但前提是原始映射本身得存在。离线环境下它不会凭空造出 classmap，只会把已有的东西打包得更紧凑。
- 如果
vendor/composer/autoload_classmap.php是空的，dump-autoload --optimize产出的autoload_static.php里$classMap一样是空数组 -
--classmap-authoritative能提升性能，但要求所有类必须出现在 classmap 中，离线时漏一个就会直接 fatal error，不如默认模式容错强 - 真正保险的做法是：在线机器上先
composer install，再composer dump-autoload --optimize，最后整体打包 vendor —— 不要试图在离线机上补操作
离线部署最危险的错觉，就是以为“vendor 目录拷过去就完事了”。autoload 是编译态产物，不是运行态配置，少一个生成步骤，整个链路就断在第一行 require 上。
