直接检查 vendor/composer/autoload_psr4.php 和 autoload_classmap.php 是 Composer 自动加载的最终执行依据；运行 composer dump-autoload 后它们被重写，内容即当前生效规则，键需带双反斜杠结尾，值路径末尾推荐带正斜杠，类名在文件中必须完全匹配（含大小写、斜杠方向）。
直接检查 vendor/composer/autoload_psr4.php 和 autoload_classmap.php
这两个文件是 Composer 自动加载的最终执行依据，不是缓存，是真相。运行 composer dump-autoload 后，它们被重写，内容即当前生效规则。
打开 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如 "App\"），确认它映射到的路径是否是你预期的绝对路径（比如 /var/www/project/src/）。注意：键必须带双反斜杠结尾，值路径末尾推荐带正斜杠（"src/"✅，"src"❌）。
再打开 vendor/composer/autoload_classmap.php，搜你实际调用的完整类名（如 "App\Controllers\HomeController"），看对应路径是否存在、拼写是否完全一致（大小写、斜杠方向、有无空格）。
- 如果 PSR-4 键没出现，说明
composer.json里autoload配置根本没被识别（JSON 格式错、拼写错、嵌套错） - 如果类名在 classmap 里找不到，但 PSR-4 映射存在，说明路径推导失败——比如配置了
"MyApp\": "app/"，但类MyApp\Http\Controllers\Home实际放在app/MyApp/Http/Controllers/Home.php，PSR-4 会截掉前缀后拼app/Http/Controllers/Home.php，自然失败
用 composer dump-autoload -v 看实时诊断输出
这个命令不只“重新生成”，它的终端输出能告诉你当前规则是否被识别、扫描了哪些目录、跳过了哪些文件、是否命中你的命名空间。
关键观察点：
- 输出里有没有类似
PSR-4 mapping: ["App\" => "src/"]的行？没有，大概率是composer.json中autoload写错层级（比如缩进错、写成autoloader）、或命名空间缺结尾反斜杠（"App"❌） - 有没有报
Parse error on line X？说明某个 PHP 文件含 BOM、语法错误或用了短标签但未开启short_open_tag，Composer 卡在那个文件上，直接定位问题文件 - 看到
Generating optimized autoload files (using classmap)？说明启用了 classmap 优化，此时autoload_psr4.php可能为空——不是 bug，是行为切换
手动触发类加载并验证行为
光看配置文件不够，得让自动加载器真正跑一次。最简单方式是写个临时脚本，require vendor/autoload.php 后尝试 new 一个类或调用一个 files 里的函数。
示例：
require __DIR__ . '/vendor/autoload.php'; new AppControllersHomeController(); // 触发 PSR-4 加载 my_helper(); // 触发 files 加载
常见失败现象和对应排查点：
-
Fatal error: Class 'AppControllersHomeController' not found：先确认vendor/autoload.php是否被引入（必须用__DIR__，不能写相对路径）；再查autoload_psr4.php里有没有"App\"条目；最后确认src/Controllers/HomeController.php文件真实存在且命名空间声明为namespace AppControllers; -
Fatal error: Cannot redeclare my_helper()：说明files数组里某个 PHP 文件被多次 require（比如你在测试 bootstrap 里又手动require 'src/helpers.php'） - 函数可用、类不可用：可能是
files里的代码依赖了尚未初始化的类（如 Laravel 的app()），因为files总是在psr-4之前加载
验证第三方包的 autoload 是否生效
别只盯着自己项目的 composer.json，第三方包的规则在它自己的 composer.json 里。
步骤：
- 运行
composer show -s guzzlehttp/guzzle，拿到它在vendor/下的实际路径 - 进入该路径，执行
grep -A 5 "autoload" composer.json，直接看它声明的autoload或autoload-dev字段 - 注意：
autoload字段必须在包的composer.json顶层，嵌套在extra或scripts里会被完全忽略 - 如果想确认它是否进了 classmap，去
vendor/composer/autoload_classmap.php搜它的类名（如"GuzzleHttp\Client"）
真正容易被忽略的是：autoload-dev 不参与日常请求的自动加载，即使你把它写进包的 composer.json，也不会被 vendor/autoload.php 加载，除非你额外 require —— 这意味着你在生产环境里根本用不到它声明的类，也别指望它能解决“Class not found”问题。
