如何利用ForeignKey与limit_choices_to根据前置字段限制Django模型字段选项？

问题场景 #

想要实现：添加/编辑Payment记录时，选择租户（payment_name）后，payment_property字段仅显示与该租户租凭单元（rent_unit）的unit_name一致的Property选项。原模型代码尝试用limit_choices_to结合子查询实现，但执行makemigrations时触发错误：

ValueError: This queryset contains a reference to an outer query and may only be used in a subquery.

原模型代码 #

class Property(models.Model):
    property_name = models.CharField(max_length=100)
    unit_name = models.CharField(max_length=100)

class Tenant(models.Model):
    tenant_name = models.CharField(max_length=100)
    rent_unit = models.ForeignKey(Property, on_delete=models.SET_NULL)

class Payment(models.Model):
    payment_name = models.ForeignKey(Tenant, on_delete=models.SET_NULL)
    payment_property = models.ForeignKey(Property, on_delete=models.SET_NULL, limit_choices_to={
        'pk__in': Property.objects.filter(unit_name=models.OuterRef('payment_name__rent_unit__unit_name'))
    })

错误原因 #

limit_choices_to在迁移阶段会尝试解析其中的QuerySet，但models.OuterRef仅能在子查询（如Subquery）中使用。直接将依赖外部查询的QuerySet放在pk__in后，Django会尝试单独求值该QuerySet，导致报错。

解决方案：自定义Admin表单实现动态过滤 #

limit_choices_to不支持依赖表单其他字段的动态过滤，需通过Admin自定义表单+AJAX实现需求：

1. 修改Payment模型 #

先移除limit_choices_to配置：

class Payment(models.Model):
    payment_name = models.ForeignKey(Tenant, on_delete=models.SET_NULL)
    payment_property = models.ForeignKey(Property, on_delete=models.SET_NULL)

2. 自定义Payment表单 #

在forms.py中编写表单，重写__init__方法并添加前端动态更新逻辑：

from django import forms
from .models import Payment, Property

class PaymentForm(forms.ModelForm):
    class Meta:
        model = Payment
        fields = '__all__'

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 编辑已有记录时，默认过滤对应租户的Property选项
        if self.instance and self.instance.payment_name:
            tenant_rent_unit = self.instance.payment_name.rent_unit
            if tenant_rent_unit:
                self.fields['payment_property'].queryset = Property.objects.filter(unit_name=tenant_rent_unit.unit_name)
        else:
            # 新增记录时默认隐藏所有选项
            self.fields['payment_property'].queryset = Property.objects.none()

        # 给租户选择框添加change事件监听
        self.fields['payment_name'].widget.attrs['onchange'] = 'updatePaymentPropertyOptions(this.value)'

        # 注入前端AJAX逻辑
        self.media += forms.Media(js='''
            function updatePaymentPropertyOptions(tenantId) {
                const select = document.getElementById('id_payment_property');
                if (!tenantId) {
                    select.innerHTML = '<option value="">---------</option>';
                    return;
                }
                fetch(`/get_tenant_property_options/${tenantId}/`)
                    .then(res => res.json())
                    .then(data => {
                        select.innerHTML = '<option value="">---------</option>';
                        data.forEach(opt => {
                            const option = document.createElement('option');
                            option.value = opt.id;
                            option.textContent = opt.property_name;
                            select.appendChild(option);
                        });
                    });
            }
        ''')

3. 添加AJAX接口视图 #

在views.py中编写接口，返回对应租户的Property选项：

from django.http import JsonResponse
from .models import Tenant, Property

def get_tenant_property_options(request, tenant_id):
    try:
        tenant = Tenant.objects.get(pk=tenant_id)
        properties = Property.objects.filter(unit_name=tenant.rent_unit.unit_name)
        options = [{'id': p.id, 'property_name': p.property_name} for p in properties]
        return JsonResponse(options, safe=False)
    except Tenant.DoesNotExist:
        return JsonResponse([], safe=False)

4. 配置接口路由 #

在urls.py中添加路由映射：

from django.urls import path
from . import views

urlpatterns = [
    # 其他已有路由
    path('get_tenant_property_options/<int:tenant_id>/', views.get_tenant_property_options, name='get_tenant_property_options'),
]

5. 注册自定义表单到Admin #

在admin.py中关联Payment模型与自定义表单：

from django.contrib import admin
from .models import Payment
from .forms import PaymentForm

class PaymentAdmin(admin.ModelAdmin):
    form = PaymentForm

admin.site.register(Payment, PaymentAdmin)

完成以上配置后，在Admin后台操作Payment记录时，选择租户后payment_property会自动加载符合条件的选项，既解决了原报错问题，也实现了需求。

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