Django：如何在URL模式中重命名模型主键字段

没问题！在Django里要实现同一个URL使用多个模型的主键并分别命名其实很简单，我给你一步步讲清楚：

1. 核心思路：自定义URL捕获参数的名称 #

默认情况下我们用<int:pk>来捕获模型的主键，但当需要在同一个URL里使用多个模型的主键时，只需要把pk替换成自定义的名称（比如school_pk、student_pk），这样就能在视图里区分不同模型的主键值了。

2. 完整代码示例 #

第一步：补充模型（以School和Student为例） #

先给你的School模型补全get_absolute_url，再新增一个关联的Student模型，方便演示多主键场景：

# models.py
from django.db import models
from django.urls import reverse

class School(models.Model):
    name = models.CharField(max_length=256)
    principal = models.CharField(max_length=256)
    location = models.CharField(max_length=256)
    
    def __str__(self):
        return self.name
    
    def get_absolute_url(self):
        return reverse('school-detail', kwargs={'school_pk': self.pk})  # 这里也要对应自定义的参数名

class Student(models.Model):
    name = models.CharField(max_length=256)
    age = models.IntegerField()
    school = models.ForeignKey(School, on_delete=models.CASCADE)
    
    def __str__(self):
        return self.name

第二步：配置URL模式，自定义主键参数名 #

在urls.py里，我们给每个模型的主键指定专属的参数名：

# urls.py
from django.urls import path
from . import views

urlpatterns = [
    # 单个模型的URL，自定义主键名为school_pk
    path('schools/<int:school_pk>/', views.school_detail, name='school-detail'),
    # 包含两个模型主键的URL，分别命名为school_pk和student_pk
    path('schools/<int:school_pk>/students/<int:student_pk>/', views.student_detail, name='student-detail'),
]

第三步：在视图中接收并使用自定义参数 #

函数视图（FBV）的写法

直接把自定义的参数名作为视图函数的参数，然后用它查询对应的模型：

# views.py
from django.shortcuts import get_object_or_404, render
from .models import School, Student

def school_detail(request, school_pk):
    # 用school_pk替代默认的pk来查询School模型
    school = get_object_or_404(School, pk=school_pk)
    return render(request, 'school_detail.html', {'school': school})

def student_detail(request, school_pk, student_pk):
    school = get_object_or_404(School, pk=school_pk)
    # 同时使用两个主键参数，还可以关联验证学生属于该学校
    student = get_object_or_404(Student, pk=student_pk, school=school)
    return render(request, 'student_detail.html', {'school': school, 'student': student})

类视图（CBV）的写法

如果用基于类的视图（比如DetailView），需要设置pk_url_kwarg属性来指定URL中的主键参数名：

# views.py
from django.views.generic import DetailView
from django.shortcuts import get_object_or_404
from .models import School, Student

class SchoolDetailView(DetailView):
    model = School
    pk_url_kwarg = 'school_pk'  # 指定URL中捕获的主键参数名
    template_name = 'school_detail.html'

class StudentDetailView(DetailView):
    model = Student
    pk_url_kwarg = 'student_pk'  # 指定Student模型的主键参数名
    template_name = 'student_detail.html'
    
    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        # 通过self.kwargs获取URL中的school_pk参数
        context['school'] = get_object_or_404(School, pk=self.kwargs['school_pk'])
        return context

对应的URL配置需要改成类视图的调用方式：

# urls.py
urlpatterns = [
    path('schools/<int:school_pk>/', views.SchoolDetailView.as_view(), name='school-detail'),
    path('schools/<int:school_pk>/students/<int:student_pk>/', views.StudentDetailView.as_view(), name='student-detail'),
]

3. 关键注意点 #

• 确保get_absolute_url里的kwargs和URL中的参数名一致，不然反向解析会出错
• 视图中接收的参数名必须和URL里定义的完全匹配
• 如果是多模型关联的场景，可以在查询时额外验证主键之间的关联关系（比如学生属于指定学校），避免非法访问

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