SqlAlchemy版本迁移：Postgres数组any()大小写不敏感过滤报错及兼容方案

安全阿岳

2026-8-1

兼容SqlAlchemy 1.3和1.4的数组大小写不敏感查询方案

针对PostgreSQL数组列nicknames（类型ARRAY(String(64))）的大小写不敏感匹配需求，原代码因1.4版本中any方法的operator参数处理逻辑变更报错，以下是两种兼容两个版本的实现方式：

方式一：使用`array_to_string`结合模糊匹配

利用PostgreSQL内置函数array_to_string将数组转为字符串，通过ilike完成匹配，建议使用特殊分隔符避免元素间的误匹配：

from sqlalchemy import func

session.query(Horse).filter(
    func.array_to_string(Horse.nicknames, '|||').ilike('%charlie%')
)

该方式实现简单，适合元素中不含选定分隔符的场景。

方式二：使用`unnest`展开数组+子查询（精准匹配）

通过unnest函数展开数组元素，结合exists子查询逐个检查元素，避免误匹配：

from sqlalchemy import exists, select

# 小写转换后精准匹配
session.query(Horse).filter(
    exists(
        select(1)
        .select_from(func.unnest(Horse.nicknames).alias('n'))
        .where(func.lower(func.unnest(Horse.nicknames)) == 'charlie')
    )
)

# 或直接使用ilike匹配
session.query(Horse).filter(
    exists(
        select(1)
        .select_from(func.unnest(Horse.nicknames).alias('n'))
        .where(func.cast(func.unnest(Horse.nicknames), String).ilike('charlie'))
    )
)

这种方式会逐一校验数组内的每个元素，匹配逻辑更精准，适用于所有场景。