自定义类中无法直接使用 $this->db，需显式获取数据库实例；数组参数不能直接用于 set() 或 where()，需手动处理；bind() 不自动展开数组，应改用 wherein() 或手动拼占位符。
自定义类里调用 $this->db 报 “Call to a member function on null”
这不是数据库配置错，而是你把 CI 的数据库对象当普通 PHP 对象用了。CodeIgniter 的 $this->db 只在控制器、模型、库（Library）中自动注入，**自定义类（比如放在 app/Helpers/ 或 app/Services/ 下的纯 PHP 类）默认没有 $this->db 属性**。
常见错误写法：
class MyService
{
public function doSomething()
{
$this->db->select('*')->from('users')->get(); // ❌ $this->db 未定义
}
}
正确做法是显式获取 DB 实例：
- CI4：用
service('database')或\Config\Database::connect() - CI3：用
get_instance()->db（但需确保在请求生命周期内调用） - 更稳妥的 CI3 方式：在构造函数中传入实例，或通过
$CI =& get_instance()获取后缓存
绑定数组参数时 SQL 报错 “Unknown column 'Array' in field list”
这是把 PHP 数组直接塞进 where() 或 set() 导致的典型错误，比如：
$data = ['name' => 'Alice', 'roles' => ['admin', 'editor']];
$this->db->set($data)->insert('users'); // ❌ roles 值是数组，CI 不会自动序列化
CI 的 Query Builder 不会递归处理嵌套数组，roles 字段会被当成字符串字面量 'Array' 插入，最终触发 MySQL 错误。
修复方式取决于你的业务意图：
- 如果想存 JSON 字符串：手动
json_encode($data['roles'])后再 set - 如果字段是 VARCHAR/TEXT 类型且只存逗号分隔值：
implode(',', $data['roles']) - 如果是多对多关系：不要塞进主表，该建中间表就建中间表，用事务批量插入
- CI4 支持原生数组绑定（如
whereIn('id', [1,2,3])），但仅限 WHERE 条件，不适用于 SET 或 VALUES
使用 bind_param() 风格手动绑定被误用
有人试图模仿 PDO 的 bind_param() 写法，在 CI 里手动拼 SQL 并传数组参数，比如：
$sql = "INSERT INTO logs (user_id, action, data) VALUES (?, ?, ?)"; $this->db->query($sql, $params); // ✅ 这个语法 CI 是支持的
但容易踩的坑是：
-
$params必须是**一维索引数组**，不能是关联数组：['1', 'login', '{"ip":"127.0.0.1"}']✔️，['user_id'=>1, ...]❌ - 参数数量必须与 SQL 中
?严格一致，少一个或多一个都会报错或静默失败 - 字符串类型参数不需要额外加引号，CI 会自动转义；但 NULL 值要写成
null，不能是字符串'NULL' - 这种写法绕过了 Query Builder，也失去了防注入保障 —— 除非你确认
$params全部来自可信来源，否则慎用
CI4 中使用 Raw SQL + bind() 时数组展开失败
CI4 允许用 bind() 方法绑定命名参数，但很多人写成：
$builder->setQuery("SELECT * FROM users WHERE status IN :statuses:")
->bind(['statuses' => ['active', 'pending']]); // ❌ 不会自动展开为 ('active','pending')
CI4 的 bind() **不会自动展开数组为多个占位符**，它只会把整个数组当做一个值传进去，结果变成 IN 'Array'。
正确解法只有两个：
- 用
whereIn()：它专为数组设计，会生成IN ('active', 'pending') - 手动拼占位符：先算数组长度，生成对应数量的
:status1:, :status2:，再用循环绑定每个键
最易忽略的一点：所有绑定操作必须在 get() 或 execute() 之前完成，顺序错乱会导致绑定失效，且无任何提示。
