如何在Django REST Framework中通过邮箱获取关联字段详情及to_field作用？

一、通过用户邮箱获取偏好设置的正确实现 #

你的代码报错是因为UserPreferences模型本身没有email字段，lookup_field="email"自然找不到对应字段。可以通过两种方式实现需求：

方法1：利用关联字段的双下划线查询 #

直接通过UserPreferences关联的User模型的email字段进行过滤，配置如下：

from rest_framework import generics
from .models import UserPreferences, User
from .serializers import UserPreferencesSerializer

class UserPreferencesRetrieveView(generics.RetrieveAPIView):
    serializer_class = UserPreferencesSerializer
    queryset = UserPreferences.objects.all()
    # 通过关联的User模型的email字段查询
    lookup_field = "user__email"
    # 对应URL中传递的参数名，比如URL是/preferences/<str:email>/
    lookup_url_kwarg = "email"

对应的URL配置示例：

from django.urls import path
from .views import UserPreferencesRetrieveView

urlpatterns = [
    path('preferences/<str:email>/', UserPreferencesRetrieveView.as_view(), name='user-preferences'),
]

方法2：重写get_object方法手动查询 #

如果需要更灵活的逻辑（比如额外的权限校验），可以手动查询用户再获取其偏好：

from rest_framework import generics
from django.shortcuts import get_object_or_404
from .models import UserPreferences, User
from .serializers import UserPreferencesSerializer

class UserPreferencesRetrieveView(generics.RetrieveAPIView):
    serializer_class = UserPreferencesSerializer

    def get_object(self):
        # 从URL参数中获取邮箱
        email = self.kwargs.get('email')
        # 先找到对应的用户，不存在则返回404
        user = get_object_or_404(User, email=email)
        # 获取该用户的偏好设置，不存在则返回404
        return get_object_or_404(UserPreferences, user=user)

二、to_field参数的作用 #

你提到数据库中UserPreferences的user_id仍存储用户id，这大概率是因为以下两个原因之一：

1. User模型的email字段未设置unique=True（OneToOneField要求关联字段必须唯一，否则to_field无法生效）；
2. 设置to_field后未执行makemigrations和migrate命令，模型变更未同步到数据库。

to_field的核心作用是指定关联模型中用来建立一对一关联的字段：

• 默认情况下，Django会使用关联模型的主键（比如User的id）作为关联依据，外键字段存储主键值；
• 当设置to_field="email"时：
  • 必须保证User的email字段是唯一的（即email = models.EmailField(unique=True)）；
  • UserPreferences的外键字段会存储User的email值，而非id；
  • 查询关联数据时，Django会通过email字段匹配，而不是id。

如果需要让to_field生效，先检查User模型的email字段是否加了unique=True，然后执行以下命令同步数据库：

python manage.py makemigrations
python manage.py migrate

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