CI4控制器构造函数中不能直接new Database实例，必须通过\Config\Services::database()获取已初始化的连接实例，否则会破坏连接池、事务上下文和配置复用，并导致类未找到或connID缺失错误。
CI4 控制器构造函数里不能直接 new Database 实例
CodeIgniter 4 的 Database 类不是靠 new 创建的，也不能在构造函数里手动实例化。框架通过服务容器统一管理数据库连接，硬写 new \CodeIgniter\Database\MySQLi\Connection(...) 会破坏连接池、事务上下文和配置复用，且无法自动注入到模型中。
常见错误现象：Fatal error: Uncaught Error: Class 'CodeIgniter\Database\MySQLi\Connection' not found，或后续调用 $db->table() 报错说缺少 connID。
- 必须走
\Config\Services::database()获取实例（默认组） - 若需非默认组，用
\Config\Services::database('group_name') - 该调用返回的是已初始化、带连接状态的
BaseConnection子类实例
正确加载数据库的两种安全方式
方式一：在构造函数中显式获取并赋值给属性（推荐）
public function __construct()
{
parent::__construct(); // ⚠️ 必须第一行！否则 Services 不可用
$this->db = \Config\Services::database(); // 默认数据库
$this->db2 = \Config\Services::database('external'); // 指定组
}
方式二：按需懒加载（适合不总用 DB 的控制器）
public function index()
{
$db = \Config\Services::database();
$users = $db->table('users')->get()->getResult();
return view('users', ['users' => $users]);
}
- 方式一适合需要在多个方法中复用同一连接的场景
- 方式二避免无谓初始化，内存更轻，但每次调用都走服务解析
- 两者都兼容事务控制（
$this->db->transStart()）
动态数据库连接不能塞进构造函数参数
CI4 不支持在控制器构造函数里声明形如 __construct(\CodeIgniter\Database\BaseConnection $db) 并期望自动注入——服务容器不会为控制器解析这种类型提示，会直接报 Too many arguments to method。
如果你需要根据请求参数切换数据库（比如多租户），必须在方法内构建配置并手动创建连接：
public function import_from_external()
{
$config = [
'DSN' => '',
'hostname' => $this->request->getPost('host'),
'username' => $this->request->getPost('user'),
'password' => $this->request->getPost('pass'),
'database' => $this->request->getPost('db'),
'DBDriver' => 'MySQLi',
// ... 其他必要字段
];
$db = \Config\Database::connect($config); // 注意是 Database::connect(), 不是 Services::database()
$data = $db->table('source_table')->get()->getResult();
// 写入主库...
}
-
\Config\Database::connect()是唯一支持运行时配置的入口 - 它返回的连接不参与服务容器生命周期管理，用完不自动关闭，建议显式
$db->close() - 不要尝试把它赋给
$this->db，会覆盖默认连接导致后续方法异常
autoload.php 里配 database 无效
CodeIgniter 4 已废弃 $autoload['libraries'] = ['database'] 这种写法。该配置只对 CI3 生效，CI4 中即使写了也完全不起作用，$this->db 依然为 null。
真正起作用的只有两处：
-
app/Config/Database.php里的$defaultGroup和各组定义 - 代码中显式调用
\Config\Services::database()或\Config\Database::connect()
别被旧文档误导——CI4 的数据库加载是“按需触发 + 容器托管”，没有全局自动加载机制。构造函数里漏掉 parent::__construct()，或者试图绕过 Services 直接操作底层类，是最常踩的两个深坑。
