最优先检查报错堆栈顶部的完整类名，如class 'apphttpcontrollersdashboardcontroller' not found，核对命名空间、大小写、拼写、斜杠方向及文件路径是否符合psr-4规范。
看报错信息里具体是哪个类没找到
这是最优先的动作。Laravel 报错堆栈顶部通常会明确写出 Class 'AppHttpControllersDashboardController' not found 这类信息，重点盯住单引号内的完整类名——包括命名空间、大小写、拼写、斜杠方向。
常见干扰项：
- 类名大小写不一致（如
DashBoardControllervsDashboardController）：本地开发环境（macOS/Windows）常不敏感，但生产服务器（Linux）严格区分 - 命名空间末尾多写了反斜杠，比如
AppHttpControllers\（双反斜杠在字符串中会被转义，导致解析失败） - 用了中文全角字符或不可见空格，尤其在复制粘贴路由定义或
use语句时
确认类文件是否存在且路径匹配 PSR-4
Laravel 依赖 Composer 的 PSR-4 自动加载，类名必须和文件路径严格对应。例如 AppHttpControllersUserProfileController 必须位于 app/Http/Controllers/UserProfileController.php。
检查步骤：
- 用
ls -l app/Http/Controllers/UserProfileController.php（Linux/macOS）或资源管理器确认文件真实存在 - 打开该文件，第一行必须是
namespace AppHttpControllers;，不能是AppHttpControllers或漏掉分号 - 类定义必须是
class UserProfileController，不能拼成UserprofileController或带下划线 - 如果类在子目录（如
app/Modules/Admin/Controllers），需在composer.json中额外配置 PSR-4 映射
刷新自动加载 + 清理缓存
改了文件名、移动了类、或新增了命名空间后，Composer 不会自动重生成映射表。
Laravel 13.2.0 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
执行这两条命令（顺序不能错）：
-
composer dump-autoload：重新扫描所有psr-4和classmap配置，生成新的vendor/composer/autoload_psr4.php -
php artisan config:clear && php artisan cache:clear：避免旧缓存中的错误类引用被复用
注意：不要只跑 dump-autoload 就以为完事——Laravel 的 route:list 或中间件注册可能已缓存过期的类名。
排查 Scout、包开发等特殊场景
第三方扩展（如 Laravel Scout）或模块化开发中，“Class not found” 常因作用域隔离引发：
- 运行
php artisan scout:import Articles报错？必须加引号写成php artisan scout:import "AppModelsArticles"，否则 Shell 会把Articles当作参数而非类名字符串 - 用到了
ModulesFrontendHttpControllersUserController却找不到？检查composer.json中是否声明了对应 PSR-4 映射，且路径指向的是真实目录（不是软链接或未提交的 git 子模块） - 包内引入 EasyWeChat 等第三方类失败？主项目
vendor不会自动加载子包的vendor，要么把依赖提到根composer.json，要么在包的ServiceProvider中手动require vendor/autoload.php
最易被忽略的是：你以为改了文件，其实编辑的是另一个同名文件（比如 IDE 打开了 app/Http/Controllers/ 下的，实际注册路由用的是 app/Controllers/ 下的旧版本）——建议用 grep -r "class DashboardController" app/ 全局搜一遍。
