CodeIgniter批量插入数据方法详解

本文深入剖析了CodeIgniter 3和4中批量插入数据的核心方法与实战陷阱：CI3仅依赖`insert_batch()`（本质是循环单条插入，不支持原生多值SQL），而CI4的`insertBatch()`虽升级为预处理语句，但默认无事务、不分块、不返回全部自增ID；真正提升性能的关键在于手动开启事务、合理分块（建议≤500行）、关闭strict mode与自动提交，并警惕字符编码、NULL处理及调试模式等隐性瓶颈——用对方法只是起点，抠准细节才能让批量插入既快又稳。

CodeIgniter 3 的 insert_batch() 是唯一靠谱的批量插入方式

CI3 官方不支持原生多值 INSERT（比如 INSERT INTO t VALUES (),(),()），insert_batch() 是框架层唯一封装好的批量入口，它本质是把数组拆成单条 insert() 批量执行，不是真·单 SQL。别指望它能绕过 MySQL 的 max_allowed_packet 限制——数据量大时照样报错。

• 必须传入二维关联数组，键名需严格匹配字段名：[['name' => 'a', 'age' => 20], ['name' => 'b', 'age' => 22]]
• 不自动转义字段名，如果字段含空格或关键字（如 order），得手动加反引号：$this->db->field_bind('`order`', $value) 不起作用，得改数组键为 '`order`'
• 返回的是影响行数总和（int），不是布尔值；失败时只返回 FALSE，不告诉你哪一条错了

CI4 的 insertBatch() 默认走预处理，但默认不开启事务

CI4 把批量插入升级成带参数绑定的预处理语句，安全性提升，但默认每条记录单独执行 INSERT，性能没比 CI3 好多少。真正提速得靠显式事务 + 合理分块。

• 分块大小建议控制在 500 行内，超了容易触发 MySQL 的 wait_timeout 或连接中断
• 必须手动包事务：$this->db->transStart(); $this->db->table('users')->insertBatch($data); $this->db->transComplete();
• 如果表有自增主键，insertBatch() 不会返回所有生成的 ID，只返回第一条的 ID —— 别依赖它做后续关联

“批量插入很慢”大概率是因为没关 auto-commit 或没设 stricton

CI 默认每条 insert() 都提交一次，批量时 IO 次数爆炸。MySQL 服务端若开 strict mode，遇到空字符串插非空字段、时间字段填非法值等情况，整批直接失败，错误提示还藏在 $this->db->error() 里，不查就以为是超时。

• CI3：在数据库配置里加 'stricton' => FALSE，或连接后执行 $this->db->query('SET sql_mode = ""');
• CI4：在 .env 里设 database.default.DSN="mysql:host=localhost;dbname=test;charset=utf8mb4;strict=0"
• 无论哪个版本，批量前务必确认 $this->db->transOff() 没被意外调用过，否则事务不起效

想绕过框架直接拼 SQL？小心字符编码和 NULL 处理

手写 INSERT INTO ... VALUES (...),(...) 确实最快，但 CI 的查询构建器不提供这种接口，你得自己拼。这时候最常踩的坑不是语法，是 NULL 值和中文乱码。

• NULL 必须字面量写成 NULL，不能加引号，也不能用 'NULL' 或空字符串代替
• 字符串值必须用 $this->db->escape() 处理，别用 addslashes() —— 后者不识别 MySQL 的编码上下文
• 如果数据含换行符或制表符，MySQL 可能解析错位，建议先用 str_replace(["\r\n", "\n", "\r", "\t"], ' ', $val) 清洗

实际用下来，CI3 的 insert_batch() 和 CI4 的 insertBatch() 在千级数据下差异不大，真正卡住的往往是日志开关、调试模式开着，或者数据库连接用了 pconnect 却没配好超时。这些细节不盯住，换啥方法都慢。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。