CodeIgniter 4查询构建器SQL语法错误排查（本地正常线上报错）

DevOps 小满

2026-7-19

CodeIgniter 4 跨环境查询语法错误排查方案

检查数组是否被意外修改
在调用findAll()或get()->getResult()的前一行重新打印$kpi_ids，同时用spl_object_id($kpi_ids)输出数组的内存标识，和之前的打印结果对比，确认数组在查询执行前是否被清空或替换。
强制处理空数组边界
MySQL 8 不允许IN ()这类空括号的语法，而MariaDB可能兼容。即使你之前看到数组有效，也要在方法开头添加空数组校验：
```
if (empty($kpi_ids)) {
    return [];
}
```
避免生成非法SQL。
打印执行前的最终SQL
不要依赖之前的SQL打印，在执行查询前调用$builder->getCompiledSelect()输出完整SQL，对比本地和线上的SQL差异。比如CI4的MySQL8驱动可能对数组参数的转义或拼接逻辑和MariaDB驱动不同。
隔离数组传递的影响
如果$kpi_ids是引用传递过来的，可能在其他逻辑中被修改。在方法开头做数组拷贝：
```
$safeKpiIds = $kpi_ids;
```
用拷贝后的数组构建查询，避免原数组被意外篡改。
检查MySQL 8 的SQL_MODE
线上MySQL8默认的严格模式（如STRICT_TRANS_TABLES、ONLY_FULL_GROUP_BY）可能放大语法问题。执行以下SQL查看线上的模式设置：
```
SELECT @@sql_mode;
```
对比本地MariaDB的设置，临时调整线上模式测试是否解决问题，再适配查询逻辑。
原生SQL验证
把CI4生成的SQL拿到线上MySQL客户端直接执行，确认是SQL本身的问题还是框架驱动的问题。如果原生执行报错，针对性修正SQL；如果执行正常，排查CI4的查询构建器配置。