答案：Composer报错“Class not found”多因自动加载问题。1. 检查类命名空间与PSR-4配置是否完全匹配，路径大小写是否正确；2. 运行composer dump-autoload更新自动加载文件；3. 确认composer.json中autoload配置正确指向源目录；4. 查看vendor/composer/autoload_psr4.php和autoload_classmap.php确认类是否被扫描；5. 排查文件权限、系统大小写敏感性及隐藏字符问题；6. 使用class_exists验证类是否可被加载。按序排查通常可快速解决。
遇到 Composer 报错 "Class ... not found"，但你明明确认类文件存在、命名正确、路径也没问题，这种诡异情况通常不是文件缺失，而是自动加载机制出了问题。下面从几个常见角度帮你系统排查。
1. 检查类名与命名空间是否完全匹配
Composer 使用 PSR-4（或 PSR-0）自动加载，对命名空间和文件路径的映射非常严格。
- 确保类的命名空间与
composer.json中定义的 PSR-4 映射一致 - 检查大小写是否完全正确（Linux 系统区分大小写）
- 类文件名必须与类名一致（包括大小写），比如
UserService.php对应class UserService
App\Service，但目录结构是 src/service/UserService.php，小写的 service 导致无法匹配。
2. 确认 autoloader 是否已更新
即使文件存在，如果 autoloader 没有重新生成，类仍然找不到。
- 运行
composer dump-autoload或简写composer du - 如果修改了
composer.json的 autoload 配置，必须重新执行此命令 - 开发中建议加上
-o参数生成优化版本：composer du -o
可以临时用 composer dump-autoload --ansi 查看是否包含你的类路径。
3. 检查 composer.json 的 autoload 配置
确认 autoload 字段正确指向了类文件所在目录。
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
- 确保前缀以反斜杠结尾（如
App\\） - 目录路径是相对于
composer.json的，确认src/下确实有对应结构 - 改完后一定要 dump-autoload
4. 查看实际生成的自动加载映射
Composer 会生成映射文件，可以直接查看是否包含你的类。
- 打开
vendor/composer/autoload_psr4.php - 搜索你的命名空间，比如
App\，看它映射到了哪些目录 - 再打开
vendor/composer/autoload_classmap.php，搜索具体类名，看是否被收录
如果没出现在这里，说明 Composer 根本没扫描到这个文件，可能是路径或命名问题。
5. 文件权限或操作系统兼容性问题
少见但可能发生：
- 文件权限不允许读取（尤其在 Docker 或生产环境）
- 文件系统大小写不敏感（macOS/Windows）掩盖了问题，部署到 Linux 后报错
- 编辑器保存了隐藏字符或 BOM 头，导致类解析失败
6. 使用 class_exists 强制验证
调试时可以用 PHP 原生函数验证自动加载是否生效：
var_dump(class_exists('App\Service\UserService'));
返回 false 说明 autoloader 没注册成功，继续回溯上面步骤。
