SQLAlchemy中如何正确组合OR_与AND_生成预期的WHERE子句

问题场景 #

在使用SQLAlchemy构建查询过滤条件时，尝试组合or_与and_实现多条件过滤，但生成的SQL中部分AND条件未被括号包裹，导致逻辑不符合预期。

现有代码 #

if len(test1) > 0 or len(test2) > 0 or len(test3) > 0 or len(test4) > 0:
    filter_conditions = []

    if len(test1) > 0:
        filter_conditions.append(Object.test1.in_(test1))

    if len(test2) > 0:
        filter_conditions.append(Object.test2.in_(test2))

    if len(test3) > 0:
        filter_conditions.append(and_(Object.test3.in_(test3),
                                    Object.istest == 1))

    if len(test4) > 0:
        filter_conditions.append(and_(Object.test4.in_(test4),
                                    Object.istest == 1))

    final_filter_conditions = or_(*filter_conditions)
    count_query = count_query.filter(final_filter_conditions)

当前生成的SQL #

WHERE Object."istester" = :istester
AND (Object."test1" IN ([test1_1]) OR Object."test2" IN ([POSTCOMPILE_test2_1]) OR (Object."test3" IN ([POSTCOMPILE_test3_2]) AND Object."istest" = :istest_1) OR Object."test4" IN ([POSTCOMPILE_test4]) AND Object."istest" = :istest_2)

期望的SQL格式 #

WHERE Object."istester" = :istester
AND (Object."test1" IN ([test1_1]) OR Object."test2" IN ([POSTCOMPILE_test2_1]) OR (Object."test3" IN ([POSTCOMPILE_test3_2]) AND Object."istest" = :istest_1) OR (Object."test4" IN ([POSTCOMPILE_test4]) AND Object."istest" = :istest_2))

解决办法 #

问题出在test4对应的and_条件未被正确识别为一个整体条件组，可通过以下方式修复：

方式1：规范and_的写法确保条件完整性

调整代码缩进与格式，确保and_的多个条件在同一调用层级内，避免语法解析异常：

if len(test4) > 0:
    filter_conditions.append(and_(
        Object.test4.in_(test4),
        Object.istest == 1
    ))

方式2：用&操作符替代and_并显式包裹括号

通过SQLAlchemy的&操作符组合条件，并用括号明确标记整体，强制生成分组括号：

if len(test4) > 0:
    filter_conditions.append(
        (Object.test4.in_(test4)) & (Object.istest == 1)
    )

额外优化：统一所有OR分支的分组格式

如果希望所有OR分支（包括单个条件）都带括号，可将单个条件也用and_包裹，确保格式统一：

if len(test1) > 0:
    filter_conditions.append(and_(Object.test1.in_(test1)))

if len(test2) > 0:
    filter_conditions.append(and_(Object.test2.in_(test2)))

注意事项 #

确保已正确导入SQLAlchemy的核心操作符：

from sqlalchemy import and_, or_

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