Class not found 的根源在于类文件未被正确识别或路径配置错误，而非自动加载机制本身。1. 类名、命名空间与文件路径必须严格匹配，遵循 PSR-4 规范；2. composer.json 中的 autoload 配置需正确定义 psr-4、classmap 或 files 路径；3. 文件必须位于已声明的自动加载目录内，否则不会被扫描；4. OPcache 或环境差异可能导致旧缓存生效，需重启服务并确保 CLI 与 Web 环境一致。运行 dump-autoload 仅重建索引，不修复文件或配置问题。
执行 composer dump-autoload 后仍然提示 "Class not found"，通常不是自动加载本身的问题，而是类文件未被正确识别或路径配置有误。dump-autoload 只是重新生成映射关系，它不会修复源文件或配置的错误。
1. 检查类命名与命名空间是否匹配
PHP 类必须遵循 PSR-4 或 PSR-0 的命名规范。常见错误包括：
- 类名和文件名不一致（如类名为 UserHelper，但文件名为 user_helper.php）
- 命名空间声明错误或缺失
- 命名空间层级与目录结构不对应（如命名空间为 AppServices，但文件放在 src/helpers 目录下）
确保文件路径与命名空间完全匹配。例如：
// 文件路径：src/Services/UserService.php
namespace AppServices;
class UserService { }
2. 确认 composer.json 中的 autoload 配置正确
检查 composer.json 是否正确定义了自动加载规则，特别是 psr-4 或 classmap 配置。
示例（PSR-4）：
"autoload": {
"psr-4": {
"App\": "src/"
}
}
修改后必须重新运行：
composer dump-autoload
如果使用 classmap，确保包含类文件的目录已列出：
"autoload": {
"classmap": ["database/models", "legacy/"]
}
3. 文件未在预期目录中或未被扫描
Composer 只会扫描配置中指定目录下的 PHP 文件。如果类文件放在未声明的目录中，即使运行 dump-autoload 也不会被发现。
解决方法：
- 将类移到 autoload 配置指定的目录
- 更新 composer.json 添加新目录
- 对于零散文件，可使用 files 方式引入：
"autoload": { "files": ["helpers.php", "functions.php"] }
4. 缓存或 opcode 缓存干扰
某些环境下 OPcache 或 APC 可能缓存了旧的类查找结果。尝试以下操作：
- 重启 PHP-FPM 或 Apache/Nginx
- 清除 OPcache（可通过重启服务或调用 opcache_reset()）
- 确认 CLI 和 Web 使用的 php.ini 一致
另外，确保你在命令行和 Web 环境中使用的是同一个 vendor/autoload.php，且 composer.json 已正确加载。
基本上就这些。dump-autoload 不会“魔法般”让类出现，它只是重建索引。关键是文件存在、命名正确、配置无误。
