Laravel 8中模型类正确加载需严格匹配三要素：namespace声明（如App\Models）、文件路径（app/Models/User.php）、composer.json映射（"App\\": "app/"），任一大小写或反斜杠错误均导致Class not found，且必须执行composer dump-autoload生效。
在 Laravel 8 中让模型类被正确识别并自动加载，必须严格遵循 PSR-4 规范对命名空间与文件路径的双重约束——类声明的 namespace、文件物理位置、composer.json 映射三者缺一不可，任意一项大小写或斜杠方向出错都会触发 Class not found 错误。
确认模型类的命名空间声明
打开你的模型文件，例如 app/Models/User.php，检查第一行是否为：namespace AppModels;。
注意：末尾不能有多余空格，【必须用反斜杠 而非正斜杠 /】，且 App 首字母必须大写；若写成 appModels 或 App/Models，Composer 将完全忽略该文件。
这一步是整个加载链的起点，错一个字符就无法匹配 composer.json 中的映射前缀。
核对文件路径与命名空间的层级对应关系
PSR-4 要求命名空间每一段都对应一个目录层级。例如 AppModelsUser 必须位于 app/Models/User.php。
若你把文件放在 app/models/User.php（小写 models），即使 namespace 写对了，也会因路径不匹配而加载失败——Linux 系统区分大小写，Windows 下暂不报错但部署到生产环境必然崩溃。
同理，AppHttpControllersAuthLoginController 对应路径必须是 app/Http/Controllers/Auth/LoginController.php，中间不能跳级或缩略。
配置 composer.json 的 PSR-4 映射规则
在项目根目录打开 composer.json，确保 "autoload" 字段下有如下结构：
"autoload": { "psr-4": { "App": "app/" } }
注意：双反斜杠 \ 是 JSON 字符串中转义单个反斜杠的必需写法，【不能写成 "App": "app/" 或 "App": "app"】；路径值 "app/" 末尾斜杠不可省略，且必须是相对于 composer.json 的相对路径，不能加 ./ 或 ../。
如果使用多模块结构（如含 Admin、Api 命名空间），可扩展为：
"autoload": { "psr-4": { "App\": "app/", "Admin\": "admin/", "Api\": "api/" } }
强制刷新 Composer 自动加载映射
完成以上三步后，执行以下命令：
第一步：运行 composer dump-autoload → 这会重新扫描所有 psr-4 声明的路径，生成新的 vendor/composer/autoload_psr4.php 映射表。
第二步：验证映射是否生效，执行 composer show --platform 或直接 php -r "var_dump(require 'vendor/autoload.php');" 查看加载器状态。
第三步：重启开发服务器（如 php artisan serve），避免旧缓存干扰；若已启用 OPCache，需执行 php artisan opcache:clear。
这一步不可跳过——哪怕只改了一个字母，不执行 dump-autoload，Composer 仍按旧映射查找文件。
