如何在Django中查询输入列表值是否存在于模型的列表字段中

问题痛点 #

你用CharField存储逗号分隔的整数列表，直接用contains会踩坑——比如查5会误匹配15或者50，必须做精确的单个数字匹配，才能避免这类错误。

直接可用的实现代码 #

假设用户输入的房间号列表是input_rooms = [3, 63, 2, 5]，用Django的Q对象拼接OR条件，覆盖所有可能的数字出现位置：

from django.db.models import Q

input_rooms = [3, 63, 2, 5]
# 初始化空查询
query = Q()
for num in input_rooms:
    num_str = str(num)
    # 覆盖四种精确匹配场景：单独值、开头、结尾、中间
    query |= Q(room_number=num_str) \
            | Q(room_number__startswith=f"{num_str},") \
            | Q(room_number__endswith=f",{num_str}") \
            | Q(room_number__contains=f",{num_str},")

# 执行查询，得到所有有交集的记录
matching_rooms = Room.objects.filter(query)

简化的正则查询（数据库支持时用） #

如果你的数据库支持正则表达式（比如PostgreSQL、MySQL 8.0+），可以用正则直接匹配数字的边界，代码更简洁：

from django.db.models import Q

input_rooms = [3, 63, 2, 5]
query = Q()
for num in input_rooms:
    # 匹配开头/逗号+数字+逗号/结尾的边界
    query |= Q(room_number__iregex=r'(^|,){0}(,|$)'.format(num))

matching_rooms = Room.objects.filter(query)

长远优化建议 #

这种字符串存列表的方式本质上是反范式设计，数据量大时查询效率会很低。如果可以重构，优先选这两种方案：

• PostgreSQL专属：把room_number改成ArrayField(IntegerField())，直接用Room.objects.filter(room_number__overlap=input_rooms)就能完成交集查询，效率拉满
• 通用方案：新建一个RoomNumber模型，和Room建立多对多关系，完全符合数据库设计规范，查询和维护都更方便

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