Codeigniter WHERE子句查询空值/NULL时日期条件失效问题排查

需要查询满足以下条件的记录：

• 预订状态为confirmed
• 日期在2022-09-12至2023-01-15之间
• 关联的individuals表中phone字段为空字符串''或NULL

执行以下CodeIgniter查询代码后，返回记录的phone字段符合要求，但date字段全部为NULL，且日期范围条件被完全忽略：

$this->db->select('i.id, i.name, i.phone, b.date')
         ->from('bookings AS b')
         ->join('individuals AS i', 'b.individual_id = i.id')
         ->where('b.status', 'confirmed')
         ->where('b.date >=', '2022-09-12')
         ->where('b.date <=', '2023-01-15')
         ->where('i.phone = "" OR i.phone IS NULL')
         ->order_by('b.date', 'ASC')
         ->get();

返回结果示例：

object(stdClass)[129]
      public 'id' => string '52393' (length=5)
      public 'name' => string 'Mrs Janet dooley' (length=17)
      public 'phone' => null
      public 'date' => null
  1 => 
    object(stdClass)[198]
      public 'id' => string '32277' (length=5)
      public 'name' => string 'Ms Rita molongi' (length=16)
      public 'phone' => null
      public 'date' => null

问题根源 #

核心错误出在->where('i.phone = "" OR i.phone IS NULL')这一行：
CodeIgniter的where()方法在接收包含OR的字符串条件时，会自动对整个字符串进行引号转义，导致原本的逻辑条件被错误解析为单一的字符串匹配，破坏了SQL语句的逻辑结构，进而导致日期范围条件失效，最终返回不符合预期的记录（date字段为NULL）。

修复方法 #

提供两种可靠的修复方式，任选其一即可：

方式一：关闭条件转义 #

通过where()方法的第三个参数FALSE，告诉CodeIgniter不要转义传入的条件字符串，同时用括号明确逻辑优先级：

$this->db->select('i.id, i.name, i.phone, b.date')
         ->from('bookings AS b')
         ->join('individuals AS i', 'b.individual_id = i.id')
         ->where('b.status', 'confirmed')
         ->where('b.date >=', '2022-09-12')
         ->where('b.date <=', '2023-01-15')
         ->where('(i.phone = "" OR i.phone IS NULL)', NULL, FALSE)
         ->order_by('b.date', 'ASC')
         ->get();

方式二：使用分组条件 #

利用CodeIgniter的group_start()和group_end()方法包裹OR条件，确保逻辑优先级正确，避免与其他WHERE条件冲突：

$this->db->select('i.id, i.name, i.phone, b.date')
         ->from('bookings AS b')
         ->join('individuals AS i', 'b.individual_id = i.id')
         ->where('b.status', 'confirmed')
         ->where('b.date >=', '2022-09-12')
         ->where('b.date <=', '2023-01-15')
         ->group_start()
             ->where('i.phone', '')
             ->or_where('i.phone IS NULL')
         ->group_end()
         ->order_by('b.date', 'ASC')
         ->get();

这两种方式都能正确生成符合预期的SQL语句，确保所有查询条件生效，返回正确的记录。

内容的提问来源于stack exchange，提问作者Chris_g