composer如何在离线状态下调试自动加载问题？

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% 的问题。