CodeIgniter 4报错App\Models\User类未找到如何解决

核心原因 #

CI4 自动加载规则对文件路径、文件名大小写、命名空间匹配校验非常严格，已正确编写use App\Models\User引入语句但依然报类不存在，问题根源基本都是文件存放规则不匹配或自动加载缓存未更新，和现有控制器、模型的业务逻辑代码无关。

逐点排查修复 #

• 核对模型文件路径与文件名：User.php必须严格存放在项目app/Models/目录下，文件名首字母大写、后缀为小写.php，禁止命名为user.php、UserModel.php、user.PHP这类不符合规则的名称。在大小写敏感的操作系统（Linux、macOS 大小写敏感分区）上，文件名大小写不匹配会直接导致类加载失败。
• 检查文件格式：模型文件开头的<?php标签前不能有空行、HTML 输出或者 UTF-8 BOM 头，否则会打断自动加载流程。当前贴出的模型类内部代码（命名空间、继承关系、$table配置、getUsers方法）无语法错误。
• 清空自动加载缓存：如果之前开启过缓存或者运行过优化命令，新增的模型类不会被自动识别，在项目根目录执行命令清空所有缓存：

php spark cache:clear

清空后执行重新生成类映射命令，确保加载规则更新：

php spark optimize

• 验证实例化逻辑：上述步骤修复完成后，$model = new User()和$model = model(User::class)两种写法都可以正常调用getUsers()方法。如果修复后调用方法返回NULL，再单独检查数据库连接配置、users数据表是否存在即可——类找不到的报错和数据库配置无关，不需要提前调整数据库参数。

内容的提问来源于stack exchange，提问作者VenoM