CodeIgniter4控制器调用模型get_user_by_id()方法失败的快速修复方案

• 确认UserModel中已定义get_user_by_id()方法，且方法访问修饰符为public，仅public修饰的方法支持类外调用，参考示例：

// 对应路径 app/Models/UserModel.php
namespace App\Models;
use CodeIgniter\Model;

class UserModel extends Model
{
    protected $table = 'users';
    protected $primaryKey = 'id';
    // 其余模型配置项省略...

    // 必须使用public修饰
    public function get_user_by_id(int $userId = 0)
    {
        return $this->where('id', $userId)->first();
    }
}

• 检查文件路径与命名空间匹配度：UserModel的命名空间必须为namespace App\Models;，文件必须存放在app/Models/UserModel.php路径下，CI4严格区分文件名大小写，大小写不匹配会导致类加载失败。
• 检查方法参数是否匹配：如果get_user_by_id()定义时要求传入用户ID参数，调用时必须传递对应数值，比如将调用代码修改为$this->base->get_user_by_id(1);，参数缺失会抛出调用错误。
• 确认继承关系正确：UserModel必须正确继承CI4的基类Model，如果自定义方法放在你自己封装的公共基础模型中，也要确认UserModel正确继承了对应的基础模型。
• 可选优化方案：使用CI4的依赖注入特性自动实例化模型，无需手动new对象，简化代码：

namespace App\Controllers;
use App\Models\UserModel;
class Home extends BaseController
{
    public function index(UserModel $base)
    {
        $base->get_user_by_id(1);
        return view('welcome_message');
    }
}

• 调试排查：如果仍存在报错，开启调试模式查看具体错误原因：打开项目根目录.env文件，修改配置为CI_ENVIRONMENT = development，可直接看到具体报错类型（比如方法未定义、参数不匹配、表不存在等）。

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