PostgreSQL使用psycopg2传NULL值触发IN语法错误解决方案

这个报错和SQL运行时的短路求值规则没有关系：

• SQL语法校验发生在语句解析、执行计划生成阶段，优先级远高于实际运行环节。只要语句存在不符合语法规范的片段，无论运行时逻辑会不会走到对应分支，都会直接抛出语法错误。
• 标准SQL中IN谓词的右侧仅支持两类合法写法：括号包裹的值列表/行构造器、子查询，IN NULL本身就是非法语法结构。因此PostgreSQL解析器看到生成的some_column IN NULL片段时会直接报错，根本不会进入执行阶段触发你预期的短路逻辑。

不需要修改Python端的参数传入逻辑，也不需要额外新增绑定变量，仅调整WHERE子句的写法，将IN替换为= ANY即可：

WHERE %(variable)s is null OR some_column = ANY(%(variable)s)

适配逻辑说明 #

• 当传入None（对应SQL的NULL）作为variable参数时，语句会被解析为WHERE NULL is null OR some_column = ANY(NULL)，不存在语法非法的片段，可以正常通过校验；运行时OR左侧表达式判定为真，会直接触发短路，不会计算右侧表达式结果，完全符合「参数为空时跳过该字段过滤」的预期逻辑。
• 当传入Python列表/元组作为variable参数时，psycopg2会自动将Python序列适配为PostgreSQL原生数组格式，some_column = ANY(适配后的数组)的执行效果和原写法some_column in (值列表)完全一致，不会改变非空参数下的原有查询行为。
• 该写法对于单列查询的执行效率和原IN写法完全一致，支持正常命中索引，没有额外性能开销。

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