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 只是重新生成映射关系，它不会修复源文件或配置的错误。
PHP 类必须遵循 PSR-4 或 PSR-0 的命名规范。常见错误包括：
确保文件路径与命名空间完全匹配。例如：
// 文件路径：src/Services/UserService.php
namespace AppServices;
class UserService { }
检查 composer.json 是否正确定义了自动加载规则，特别是 psr-4 或 classmap 配置。
示例（PSR-4）：
"autoload": {
"psr-4": {
"App\": "src/"
}
}
修改后必须重新运行：
composer dump-autoload
如果使用 classmap，确保包含类文件的目录已列出：
"autoload": {
"classmap": ["database/models", "legacy/"]
}
Composer 只会扫描配置中指定目录下的 PHP 文件。如果类文件放在未声明的目录中，即使运行 dump-autoload 也不会被发现。
解决方法：
"autoload": {
"files": ["helpers.php", "functions.php"]
}
某些环境下 OPcache 或 APC 可能缓存了旧的类查找结果。尝试以下操作：
另外，确保你在命令行和 Web 环境中使用的是同一个 vendor/autoload.php，且 composer.json 已正确加载。
基本上就这些。dump-autoload 不会“魔法般”让类出现，它只是重建索引。关键是文件存在、命名正确、配置无误。以上就是为什么 composer dump-autoload 后依然提示 Class not found？的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
378
收藏
