SQLAlchemy filter方法常见问题：如何处理动态条件查询？

动态条件查询的典型痛点

在使用SQLAlchemy进行数据库查询时，开发者经常需要根据业务逻辑动态构建查询条件。filter方法的链式调用虽然直观，但在处理动态条件时会遇到几个典型问题：

• None值导致的意外过滤
• 条件运算符的类型不匹配
• 多条件组合时的逻辑错误
• 动态字段名带来的安全隐患

1. None值处理陷阱

# 错误示例：当search_name为None时会过滤掉所有记录
query = session.query(User).filter(User.name == search_name)

# 正确做法应增加条件判断
if search_name:
    query = query.filter(User.name == search_name)

2. 动态字段名解决方案

当需要根据变量决定过滤字段时，直接使用getattr可能引发SQL注入风险：

# 不安全实现
field = request.args.get('sort_field')
query.filter(getattr(User, field) == value)

# 安全实现应该白名单校验
valid_fields = {'name', 'email', 'created_at'}
if field in valid_fields:
    query.filter(getattr(User, field) == value)

高级条件构建方案

1. 使用sqlalchemy.sql.expression组合条件

from sqlalchemy.sql import and_, or_

conditions = []
if start_date:
    conditions.append(User.created_at >= start_date)
if end_date:
    conditions.append(User.created_at <= end_date)

query = session.query(User).filter(and_(*conditions))

2. 利用字典生成动态查询

filter_map = {
    'status': User.status == 'active',
    'age_gt': User.age > 18,
    'name_like': User.name.like('%张%')
}

active_users = session.query(User).filter(*[
    clause for key, clause in filter_map.items() 
    if request.args.get(key)
])

性能优化技巧

通过合理使用复合索引和查询计划分析，可以显著提升动态查询性能。建议在开发阶段启用SQLAlchemy的echo=True参数查看生成的SQL语句。