You need to enable JavaScript to run this app. Laravel 8上线后提示Class 'App\Models\user' not found报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

Laravel 8上线后提示Class 'App\Models\user' not found报错如何解决

Laravel 8 线上 Class 'App\Models\user' not found 报错排查方案

该问题大概率由本地开发环境(Windows/macOS)文件系统大小写不敏感、线上Linux环境大小写敏感触发,按以下步骤逐一排查即可:

  • 检查模型文件与类名大小写
    确认app/Models目录下用户模型文件名为User.php(首字母大写),文件内部类声明为class User extends Model,与引用名称大小写完全匹配。

  • 排查全局小写user引用
    重点排查登录关联逻辑与配置文件:

    1. 查看config/auth.php下providers.users.model配置项,确认值为App\Models\User::class,而非小写的App\Models\user::class或字符串形式的'App\Models\user'
    2. 全局搜索项目中所有硬编码的App\Models\user字符串引用,全部替换为标准的App\Models\User::class写法,避免手动拼写大小写错误。
  • 清理项目缓存
    线上修改代码后必须清理所有Laravel缓存,依次执行以下命令:

    # 清理所有类型缓存
    php artisan optimize:clear
    # 生产环境可在清理后执行以下命令生成新的配置、路由缓存
    php artisan optimize
    
  • 重新生成Composer自动加载文件
    执行以下命令更新类自动加载映射,排除旧映射缓存导致的类加载失败问题:

    composer dump-autoload
    
  • 检查文件权限
    确认app/Models/User.php文件权限设置正确,web服务运行用户(如www-data、nginx)对该文件拥有可读权限,权限不足也会触发类加载失败报错。

内容的提问来源于stack exchange,提问作者Rishabh

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.11 09:09:04