Class未找到错误通常因自动加载机制失效，主要原因是命名空间与目录结构不匹配、未执行composer dump-autoload更新映射、文件名与类名大小写不一致、未引入vendor/autoload.php或composer.json中PSR-4配置路径错误。
出现 "Class ... not found" 错误，但文件确实存在，通常不是文件缺失问题，而是自动加载机制未能正确识别或映射该类。Composer 使用 PSR-4 或 PSR-0 自动加载规则，以下是最常见的几个原因和解决方法：
1. 命名空间与目录结构不匹配
Composer 依赖命名空间和目录路径的对应关系自动加载类。如果命名空间写错或目录层级不符，即使文件存在也无法加载。
示例：
你在 src/Utils/Helper.php 中定义了类：
namespace App\Utils;
class Helper {}
但 composer.json 配置为：
"autoload": {
"psr-4": {
"App\\": "src/"
}
}这时应确保文件路径是 src/Utils/Helper.php，且命名空间完全匹配。
2. 未重新生成自动加载映射
添加新类或修改目录结构后，必须运行以下命令更新自动加载缓存：
-
composer dump-autoload（推荐） - 或更彻底的：
composer dump-autoload --optimize
这会重新生成 vendor/composer/autoload_psr4.php 等映射文件，确保新类被收录。
3. 文件命名不符合 PSR 标准
PSR-4 要求文件名与类名一致（包括大小写）。例如：
- 类名为
UserService，文件必须是UserService.php - 不能是
userservice.php或user_service.php（除非类名也改）
4. autoloader 未引入
确保在使用类之前引入了 Composer 的自动加载文件：
require_once __DIR__ . '/vendor/autoload.php';
遗漏这行代码会导致所有类都无法自动加载。
5. composer.json 配置错误
检查 composer.json 中的 autoload 配置是否正确指向源码目录：
"autoload": {
"psr-4": {
"MyApp\\": "app/"
}
}
路径是相对项目根目录的，不要写错目录名或拼写命名空间。
基本上就这些。多数情况是命名空间、路径或未执行 dump-autoload 导致的。检查清楚后运行一遍命令，问题通常能解决。
