CodeIgniter4读写分离避坑指南与最佳实践-php教程-PHP中文网

codeigniter 4 原生不支持数据库读写分离，因模型默认使用 $dbgroup = 'default' 且 basemodel 懒加载 $this->db，手动调用 database::connect() 不会自动绑定至模型，导致 find()、insert() 等方法仍走配置中 default 组（常设为从库），引发事务失效、主从延迟读脏数据等问题；正确做法是继承 basemodel 并通过 protected $dbgroup 声明式指定连接组，配合构造函数或方法内动态切换，避免混用 dbgroup() 与 database::connect()。

codeigniter4读写分离避坑指南与最佳实践

CodeIgniter 4 原生不支持数据库读写分离，直接在 app/Config/Database.php 里配多个组、再手动切连接，很容易导致事务失效、主从延迟读取脏数据、或模型方法意外走错连接。

为什么 `$db->table()` 会走错连接？

CI4 的 BaseModel 默认使用 default 数据库组，即使你在构造函数里用 \Config\Database::connect('write') 拿到主库连接，只要没显式绑定到模型实例，后续所有 find()、insert() 都仍走配置里的 default 组——而这个组你很可能设成了从库。

模型未指定连接时，始终读取 Database::$defaultGroup 对应的配置
$this->db 在模型中是懒加载的，首次访问才初始化，且不继承构造时手动创建的连接
事务（transStart()）必须全程使用同一连接，跨连接调用会静默失败

如何让 `UserModel` 写主库、读从库？

不能靠“运行时切换配置”，得靠模型级连接绑定 + 方法级路由控制。标准做法是：继承 BaseModel，重写 __construct() 并按需指定连接组名，再在具体方法里明确区分读写路径。

在模型构造函数中不直接 new 连接，而是调用 DBGroup('write') 或 DBGroup('read')
写操作统一走 protected $DBGroup = 'write';，并在 insert()、update() 前强制设置
读操作（如 find()、findAll()）可覆盖为先查从库，但需加 if ($this->db->getPlatform() === 'MySQL') { ... } 避免 SQLite 环境报错

示例：

CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包，并整理框架安装、数据库配置与入门开发说明。

下载

class UserModel extends BaseModel
{
    protected $table = 'users';
    protected $DBGroup = 'read'; // 默认走从库

    public function __construct()
    {
        parent::__construct();
        // 强制写操作用主库
        if (in_array($this->request->getMethod(), ['post', 'put', 'delete'])) {
            $this->DBGroup = 'write';
        }
    }

    public function insert($data)
    {
        $this->DBGroup = 'write';
        return parent::insert($data);
    }
}