答案是检查命名空间与路径匹配、确认composer.json的autoload配置、运行composer dump-autoload更新映射、确保引入vendor/autoload.php，并可通过查看autoload_psr4.php调试，多数问题由此解决。
遇到 "Class '...' not found" 错误时，通常是 Composer 自动加载机制未能正确识别或加载目标类。这个问题在开发 PHP 项目时很常见，但排查起来并不复杂。以下是几个关键排查方向和解决方法。
1. 检查命名空间与文件路径是否匹配
Composer 使用 PSR-4（或 PSR-0）自动加载标准，要求类的命名空间结构与目录结构严格对应。
常见错误示例：- 命名空间写成 AppControllerUserController，但文件放在 src/user/ 目录下
- 文件名与类名不一致，比如类叫 User，但文件名为 user.php（应为 User.php）
建议： 确保命名空间、文件目录层级、文件名三者完全一致。例如：
命名空间：AppControllersUser 预期路径：src/Controllers/User.php
2. 确认 composer.json 中的 autoload 配置正确
检查 composer.json 文件中的 autoload 字段是否正确指向了你的源码目录。
例如使用 PSR-4 的典型配置：
"autoload": {
"psr-4": {
"App\": "src/"
}
}
如果类在 src/ 目录下，但命名空间前缀未正确映射，自动加载就会失败。
注意： 命名空间末尾的反斜杠 和目录路径都要准确无误。
3. 运行 dump-autoload 更新自动加载文件
即使修改了 composer.json 或新增了类文件，也必须重新生成自动加载映射。
执行以下命令：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
composer dump-autoload
或者简写：
composer du
如果修改了 composer.json 中的 autoloading 配置，推荐加 --optimize 参数：
composer dump-autoload --optimize
这会强制重建所有自动加载映射，避免缓存问题。
4. 检查是否遗漏了 require autoload.php
确保在入口文件（如 index.php）中引入了 Composer 的自动加载文件：
require __DIR__ . '/vendor/autoload.php';
如果没有这行代码，PHP 根本不会启用 Composer 的自动加载机制，必然报错“类未找到”。
5. 查看已生成的自动加载映射（高级调试）
Composer 生成的自动加载映射保存在 vendor/composer/ 目录下：
- autoload_psr4.php：PSR-4 映射表
- autoload_classmap.php：类映射数组（用于 classmap 方式）
可以打开这些文件，搜索你的类名或命名空间，确认是否被正确注册。
如果没出现在里面，说明 dump-autoload 没扫描到该文件，可能是路径或命名问题。
基本上就这些。多数“Class not found”问题都出在命名空间与路径不匹配，或忘记运行 dump-autoload。只要按步骤检查 autoload 配置、文件结构和自动加载引入，一般都能快速定位解决。
