composer dump-autoload -v 是最快速验证 PSR-4 配置是否生效的方式，它直接暴露命名空间是否被识别；若输出无 "App\" 等配置项，说明 composer.json 存在格式错误（如缺反斜杠、BOM、注释等）；需结合检查 autoload_psr4.php 和 class_exists() 确认映射与加载真实性。
composer dump-autoload -v 会直接暴露 PSR-4 配置是否被识别
运行 composer dump-autoload -v 是最快速验证 PSR-4 配置是否生效的方式。它不猜测、不缓存，只如实打印 Composer 解析 composer.json 后的行为。
如果输出里压根没出现你写的命名空间（比如 "App"），说明配置根本没被读进去——不是路径错，是 JSON 本身有硬伤。
- 检查
composer.json是否含非法逗号、BOM 头、单引号或注释（Composer 不支持） -
"psr-4": {"App": "src/"}❌ 缺少末尾反斜杠，必须写成"App" - 路径不能带
./或../，只能是"src/"这样的纯相对路径 - 改完立刻执行
composer dump-autoload -v，别等install或update
用 php -r 直接查 autoload_psr4.php 里的真实映射
vendor/composer/autoload_psr4.php 是 PSR-4 映射的最终真相，不是缓存，是运行时唯一依据。
执行 php -r "var_dump(require 'vendor/composer/autoload_psr4.php');"，看你的命名空间是否出现在数组里，以及对应路径是否是你预期的物理位置（如 $baseDir . '/src'）。
- 如果没出现，回到上一步检查
composer.json格式和反斜杠 - 如果出现了但路径不对（比如指向
/tmp/project/src而实际代码在/app），说明部署时$baseDir计算出错，常见于构建镜像后未重跑dump-autoload - Linux 下注意大小写：
src/Http/和src/http/是两个目录，映射表里写的Http就不会匹配到小写目录
class_exists() 是最可靠的运行时验证手段
IDE 补全、php -l、甚至 composer validate 都不能代替真实加载判断。真正能证明类是否可加载的，只有 class_exists()。
在目标环境（尤其是生产服务器）上执行：
php -r "require 'vendor/autoload.php'; var_dump(class_exists('AppHttpControllersHomeController'));"
返回 bool(false) 就坐实 autoload 失效。此时再结合 dump-autoload -v 和 autoload_psr4.php 对比，问题几乎必现。
- 确保
vendor/autoload.php是用require __DIR__ . '/vendor/autoload.php';引入的，路径不能依赖当前工作目录 - 如果类文件存在但返回
false，重点查文件权限、BOM、短标签、或命名空间声明是否漏了末尾反斜杠（namespace AppHttpControllers;✅，namespace AppHttpControllers❌） - 本地 macOS 正常、线上 Linux 报错？90% 是大小写或路径拼写差异，别信“应该一样”
PSR-4 映射失败的根本原因不是“没扫描”，而是“没匹配”
PSR-4 不扫描文件，只做字符串前缀匹配 + 硬编码路径拼接。它的逻辑极其机械：
收到类名 AppHttpControllersUserController → 在 autoload_psr4.php 里找以 "App" 开头的键 → 剥离前缀得 HttpControllersUserController → 把 全替换成 / → 拼上配置的目录 src/ → 加 .php → 最终路径为 src/Http/Controllers/UserController.php。
- 这个过程不修正大小写、不 fallback、不忽略多余目录层
- 如果你的文件实际在
src/App/Http/Controllers/UserController.php，那就会去src/Http/Controllers/找，必然失败 - 命名空间声明、目录结构、
composer.json中的前缀三者必须完全对齐，差一个字符（包括反斜杠、大小写、斜杠方向）就断链 - 扩展包的 PSR-4 必须在包自己的
composer.json里配，项目根目录的配置对它无效
真实项目里最容易被忽略的，是命名空间末尾那个反斜杠——它不是语法糖，是匹配边界。少一个，整个子命名空间全部失效，且毫无报错，只默默跳过。
