composer dump-autoload 离线失败因默认访问 Packagist 校验配置，解决需加 --classmap-authoritative --no-plugins --no-scripts 跳过网络请求并强制 classmap 模式。
composer dump-autoload 为什么在离线时失败？
因为默认会尝试访问 Packagist（或配置的仓库）校验 autoload 配置合法性，哪怕只是生成 autoloader。离线时 DNS 失败或连接超时会导致 dump-autoload 中断，并报类似 Could not fetch https://repo.packagist.org/packages.json 的错误。
解决办法是跳过仓库检查，只做本地解析：
- 加
--no-plugins防插件触发网络请求 - 加
--no-scripts避免 post-autoload-dump 脚本发起调用 - 最关键：用
--classmap-authoritative或--optimize（二者等价）强制走 classmap 模式，绕过 PSR-4/PSR-0 的动态路径推导逻辑——这部分在离线时容易因 vendor 目录不全或路径缓存失效而误报
离线调试 autoload 的真实路径映射
你改了 autoload 配置但 new MyClass() 还是找不到类？不是 Composer 没生效，而是 PHP 根本没查到那个路径。得看实际生成的映射表。
手动检查 vendor/composer/autoload_classmap.php（如果用了 classmap 模式）或 autoload_psr4.php：
- 确认你的命名空间前缀（如
"MyApp\": "src/"）是否出现在autoload_psr4.php里 - 检查
src/路径是否为相对 vendor 目录的正确位置（比如它应该是../src/，不是src/） - 若用
"files"加载全局函数，对应文件必须存在且可读，否则dump-autoload不报错但运行时报Call to undefined function
vendor 目录不完整时怎么让 autoload 生效？
离线环境常缺某些包（比如只拷了部分 vendor），但又想跑通自己的代码。Composer 不会因为你删了 monolog/monolog 就拒绝加载 MyApp 的类——前提是别在 autoload-dev 或 require-dev 里混用。
安全做法：
- 把业务代码的 autoload 单独提进
autoload（不是autoload-dev），并确保require列表里不包含缺失包 - 运行
composer dump-autoload --classmap-authoritative --no-plugins --no-scripts - 如果仍报
Class not found，用php -d display_errors=1 -r "var_dump(composerutoloadClassLoader::getRegisteredLoaders());"看 Loader 实例是否注册、前缀是否匹配
为什么 require_once(__DIR__.'/vendor/autoload.php') 在离线时白屏？
不是 autoload.php 本身出错，而是它内部触发了未声明的依赖类自动加载——比如某个服务提供者在 register() 里 new 了一个来自缺失包的类，此时还没走到你的代码，PHP 就抛了 Fatal error: Class 'XXX' not found。
快速定位：
- 临时注释掉
vendor/autoload.php开头的$loader->register()，改成echo "autoload loaded"; exit;，确认是加载阶段挂的 - 检查
vendor/composer/autoload_files.php，里面列出的每个文件都会被无条件require_once，任何一个出错都会中断 - 最稳妥的离线启动方式：先删掉
autoload-files和autoload-dev配置项，再 dump，避免隐式加载
离线时最麻烦的从来不是命令跑不起来，而是错误被 autoload 链路吞掉，只留一个空白页面或 500。盯住 autoload_files.php 和 ClassLoader::getRegisteredLoaders() 这两个点，基本能挖出 90% 的问题。
