Java使用PreparedStatement查询MySQL时如何处理可空字段匹配

问题核心根源 #

查询失效本质是SQL的空值比较规则导致的：

• SQL语义中，任意字段和NULL用=做等值比较，返回结果都是UNKNOWN，不会命中任何记录
• 即便通过setString()传入null参数，PreparedStatement生成的实际执行逻辑依然是col = NULL，和将null硬编码进SQL的效果完全一致，必须替换为适配空值的判断逻辑才能正常返回结果

可落地的零判空实现 #

完全可以实现无需逐一检查参数取值、自动适配空值判断的逻辑，不需要在查询前对所有传入变量做手动空值校验，只需要调整SQL中的条件判断片段，原有的参数绑定逻辑可以100%保留：

方案1：使用数据库原生的空安全等值运算符 #

主流数据库都提供了直接兼容null值的等值判断运算符，改造后和原逻辑兼容性最高：

• MySQL 场景：把所有原SQL中的col_x = ?替换为col_x <=> ?
  该运算符的逻辑是：两边值相等（包含两边都为null的场景）即返回匹配结果，不需要额外附加判断
• 支持SQL标准的数据库（PostgreSQL、SQL Server 2022+等）：把所有原SQL中的col_x = ?替换为col_x IS NOT DISTINCT FROM ?
  这是SQL标准定义的空安全判断，逻辑和MySQL的<=>完全一致：参数为null时自动等价于判断对应字段是否为null，参数为普通值时等价于普通等值判断

举个实际改造示例：
原SQL（无法命中null值记录）：

SELECT ID FROM some_table WHERE col1 = ? AND col2 = ? AND col3 = ?

改造后（兼容null值记录）：

-- MySQL 适配写法
SELECT ID FROM some_table WHERE col1 <=> ? AND col2 <=> ? AND col3 <=> ?
-- 通用SQL标准适配写法
SELECT ID FROM some_table WHERE col1 IS NOT DISTINCT FROM ? AND col2 IS NOT DISTINCT FROM ? AND col3 IS NOT DISTINCT FROM ?

改造后原有Java代码的绑定逻辑完全不用修改，直接传入可能为null的参数，就能得到正确的查询结果，完全符合零额外校验的实现效果。

方案2：全数据库兼容的通用写法 #

如果使用的数据库版本较老，不支持上述空安全运算符，也可以直接将每个等值条件替换为通用兼容逻辑，依然不需要提前判断参数是否为null：
把原来的col_x = ?替换为(col_x = ? OR (col_x IS NULL AND ? IS NULL))

注意：该写法下每个条件包含两个占位符，绑参时只需要给两个占位符传入完全相同的参数值即可，比如第一个位置传entry1，第二个位置也传entry1，哪怕值是null也不需要做特殊处理。

这个写法的运行逻辑是：

• 参数为普通值时，走col_x = ?的普通等值匹配分支
• 参数为null时，自动触发两边都为null的匹配分支
  全程不需要在Java代码里提前判断entry1的取值是否为null。

关于“是否必须前置校验空值”的回应 #

根本不是必须的。上述两种实现方案，全程不需要对传入参数做任何空值判断，只需要调整SQL的条件片段，就能保留原有参数绑定的开发习惯。
只有当你需要动态拼接SQL、或者对查询性能有极致优化需求时，才会提前判断参数值动态裁剪无效的查询条件，这属于业务层的主动设计选择，不是必须完成的前置校验步骤。

常见踩坑提示 #

• 不要为了适配空值退回字符串拼接SQL的老路，那样会失去PreparedStatement预编译的性能优势，还容易引入SQL注入风险
• 用方案2的双占位符写法时，一定要注意占位符的顺序，不要把参数值传错位置
• 空安全判断的逻辑不要和其他OR条件直接混写，必要时给每个兼容条件加括号，避免因逻辑优先级出错导致查询结果异常

内容的提问来源于stack exchange，提问作者Linda-Veronique