如何让SQLAlchemy的or_运算符仅返回第一个匹配结果？

要实现优先匹配current_user_id对应的记录，仅当无匹配时才返回DEFAULT_USER_ID记录的需求，不能直接用or_（它会返回所有符合条件的结果），可以用以下两种方案：

方案1：两次查询（逻辑简单，适合小数据量） #

先尝试获取当前用户的匹配记录，存在则直接取结果，不存在再查询默认用户的记录：

# 先查当前用户的记录
query = query.filter(
    CollectionCardLink.collection_id == card_id,
    CollectionCardLink.position.in_([0, count-1]),
    PostStyle.user_id == current_user_id
)
result = query.first()

# 无匹配时查默认用户记录
if not result:
    query = query.filter(
        CollectionCardLink.collection_id == card_id,
        CollectionCardLink.position.in_([0, count-1]),
        PostStyle.user_id == DEFAULT_USER_ID
    )
    result = query.first()

方案2：窗口函数（一次查询，效率更高） #

用ROW_NUMBER()窗口函数给记录按优先级排序，优先保留current_user_id的记录，再筛选出排序第一的结果：

from sqlalchemy import func, case

# 定义优先级：匹配current_user_id的排第1，默认用户的排第2
rank = func.row_number().over(
    order_by=case(
        (PostStyle.user_id == current_user_id, 1),
        (PostStyle.user_id == DEFAULT_USER_ID, 2),
        else_=3
    )
)

# 构造子查询，加入排序标识
sub_query = query.add_columns(rank.label('rank')).filter(
    CollectionCardLink.collection_id == card_id,
    CollectionCardLink.position.in_([0, count-1]),
    PostStyle.user_id.in_([current_user_id, DEFAULT_USER_ID])
).subquery()

# 最终取优先级最高的记录
final_result = session.query(sub_query).filter(sub_query.c.rank == 1).first()

为什么你之前的尝试无效？ #

你写的(PostStyle.user_id == current_user_id or PostStyle.user_id == DEFAULT_USER_ID)是Python层面的布尔逻辑，而非SQL条件判断。PostStyle.user_id == current_user_id是一个SQL表达式对象，在Python中它的布尔值永远为True，导致整个表达式等价于True or ...，生成的SQL不符合预期，才会优先返回默认值，这不是正确的写法。

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