Django跨多表筛选实现与序列化user字段返回主键而非用户名问题

1. 序列化仅返回user主键的问题解决 #

Django原生的serialize方法默认仅返回外键字段的主键值，要获取关联表的username有两种高适配的实现方式：

方案1：直接用values取值（轻量场景首选） #

不需要额外依赖，直接通过双下划线语法提取关联字段，再转JSON返回即可：

import json
from django.http import JsonResponse

q = json.loads(request.body)
# 双下划线__ 用于跨关联表取字段
qs = Search.objects.filter(keyword__icontains=q['q']).values('keyword', 'user__username')
return JsonResponse(list(qs), safe=False)

方案2：DRF序列化器（项目用Django REST Framework时首选） #

自定义序列化器指定关联字段映射，同时配合select_related预加载关联数据避免N+1查询：
序列化器定义：

from rest_framework import serializers
from .models import Search

class SearchSerializer(serializers.ModelSerializer):
    # 指定username取关联user表的username字段
    username = serializers.CharField(source='user.username', read_only=True)
    class Meta:
        model = Search
        fields = ('keyword', 'username')

视图调用：

q = json.loads(request.body)
# select_related预加载外键关联的user表
qs = Search.objects.filter(keyword__icontains=q['q']).select_related('user')
ser = SearchSerializer(qs, many=True)
return JsonResponse(ser.data, safe=False)

2. 跨多张数据表筛选查询实现 #

Django通过双下划线__语法支持任意层级的跨表筛选，配合Q对象可实现多条件的与/或逻辑：

基础跨表筛选 #

假设Search表除了关联User表，还关联了Post表（外键字段为related_post），需要同时筛选Post的标题、User的用户名包含搜索关键词：

from django.db.models import Q

q = json.loads(request.body)
search_key = q['q']
qs = Search.objects.select_related('user', 'related_post').filter(
    # 或逻辑：任意一个表的字段匹配即可
    Q(keyword__icontains=search_key) |
    Q(user__username__icontains=search_key) |
    Q(related_post__title__icontains=search_key)
)

注意事项 #

• 外键、一对一关联的表预加载用select_related
• 多对多、反向外键关联的表预加载用prefetch_related
• 跨表层级没有限制，例如user__department__name__icontains可直接跨三层表筛选

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