答案是检查命名空间与路径匹配、确认composer.json的autoload配置、运行composer dump-autoload更新映射、确保引入vendor/autoload.php，并可通过查看autoload_psr4.php调试，多数问题由此解决。
遇到 "Class '...' not found" 错误时，通常是 Composer 自动加载机制未能正确识别或加载目标类。这个问题在开发 PHP 项目时很常见，但排查起来并不复杂。以下是几个关键排查方向和解决方法。
Composer 使用 PSR-4（或 PSR-0）自动加载标准，要求类的命名空间结构与目录结构严格对应。
常见错误示例：建议： 确保命名空间、文件目录层级、文件名三者完全一致。例如：
命名空间：AppControllersUser 预期路径：src/Controllers/User.php
检查 composer.json 文件中的 autoload 字段是否正确指向了你的源码目录。
例如使用 PSR-4 的典型配置：
"autoload": {
"psr-4": {
"App\": "src/"
}
}
如果类在 src/ 目录下，但命名空间前缀未正确映射，自动加载就会失败。
注意： 命名空间末尾的反斜杠 和目录路径都要准确无误。
即使修改了 composer.json 或新增了类文件，也必须重新生成自动加载映射。
执行以下命令：
composer dump-autoload
或者简写：
composer du
如果修改了 composer.json 中的 autoloading 配置，推荐加 --optimize 参数：
composer dump-autoload --optimize
这会强制重建所有自动加载映射，避免缓存问题。
确保在入口文件（如 index.php）中引入了 Composer 的自动加载文件：
require __DIR__ . '/vendor/autoload.php';
如果没有这行代码，PHP 根本不会启用 Composer 的自动加载机制，必然报错“类未找到”。
Composer 生成的自动加载映射保存在 vendor/composer/ 目录下：
可以打开这些文件，搜索你的类名或命名空间，确认是否被正确注册。
如果没出现在里面，说明 dump-autoload 没扫描到该文件，可能是路径或命名问题。
基本上就这些。多数“Class not found”问题都出在命名空间与路径不匹配，或忘记运行 dump-autoload。只要按步骤检查 autoload 配置、文件结构和自动加载引入，一般都能快速定位解决。
以上就是composer 提示 "Class ‘...’ not found" 自动加载失败排查的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
530
收藏
