首先检查类命名与文件路径是否符合PSR-4规范，确保命名空间和文件位置一致；1. 确认类名、文件名大小写匹配且位于正确路径；2. 运行composer dump-autoload更新自动加载映射；3. 在入口文件引入vendor/autoload.php；4. 检查类文件是否存在语法错误；5. 验证vendor目录完整并重装依赖；6. 使用ReflectionClass调试类加载路径。
遇到 Fatal error: Uncaught Error: Class '...' not found 错误，通常意味着 PHP 在运行时找不到你引用的类。这个问题在使用 Composer 管理依赖的项目中很常见，根本原因往往是自动加载机制未能正确识别类文件路径。下面是一份实用、结构清晰的排查指南，帮你快速定位并解决问题。
1. 检查类命名与文件路径是否符合 PSR-4 或 PSR-0 规范
Composer 依赖 PSR-4（或旧的 PSR-0）自动加载规则来映射类名到文件路径。如果类命名空间或文件存放位置不符合规范，自动加载就会失败。
- 确保类的完整命名空间与
src/目录下的文件路径一致。例如：类App\Controllers\HomeController应位于src/Controllers/HomeController.php - 确认文件名与类名完全相同（包括大小写），如
UserService.php中定义class UserService - 检查
composer.json中的autoload配置是否正确映射命名空间：
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
}
}
修改后必须重新生成自动加载映射。
2. 重新生成 Composer 自动加载文件
即使代码结构正确，如果未执行 dump-autoload，Composer 的映射文件不会更新。
- 运行命令刷新自动加载映射：
composer dump-autoload或简写composer du - 如果添加了新包或修改了
autoload配置，建议加上优化选项：composer dump-autoload --optimize - 开发阶段可启用 classmap 生成调试：
composer dump-autoload --classmap-authoritative（注意：这会忽略未扫描到的类）
3. 确保已正确引入 autoload.php
很多“类未找到”错误仅仅是因为没加载 Composer 的自动加载器。
- 在入口文件（如 index.php、cli 脚本）顶部加入：
require_once __DIR__ . '/vendor/autoload.php';
路径需根据实际结构调整，确保指向正确的 vendor/autoload.php 文件。可用 var_dump(file_exists('...')); 调试路径是否正确。
4. 检查类是否存在且语法正确
有时类文件存在但因语法错误导致解析失败，Composer 无法注册该类。
- 手动检查报错中提到的类文件是否存在
- 用 PHP CLI 验证文件语法：
php -l src/Controllers/HomeController.php - 确认类定义没有拼写错误，如
class UserContorller（少个 l） - 检查命名空间声明是否遗漏或写错：
namespace App\Controllers;
5. 验证 Composer 安装完整性
若 vendor 目录缺失或部分包未安装，也会导致类找不到。
- 确认
vendor/目录存在且包含composer/autoload_*.php文件 - 尝试重新安装依赖：
composer install - 如果是部署环境，确保没有忽略
vendor/目录（如 .gitignore 错误配置）
6. 使用 Composer 查找类对应的文件
利用 Composer 命令行工具诊断类是否被识别。
- 查询某个类会被加载自哪个文件：
composer show --verbose不够直接，推荐使用调试脚本：
$loader = require 'vendor/autoload.php';
$reflection = new ReflectionClass('App\Controllers\HomeController');
echo $reflection->getFileName(); // 输出实际加载路径
如果抛出异常，说明自动加载仍未生效。
基本上就这些。大多数“Class not found”问题都源于路径映射错误、缺少自动加载引入或未执行 dump-autoload。按以上步骤逐一排查，99% 的情况都能解决。不复杂但容易忽略细节。
