Django Rest Framework中PK默认验证及规范化校验方法咨询

嘿，这个问题问到点子上了，我刚好对DRF这部分的逻辑熟得很，给你拆解清楚：

一、URL中PK参数的默认“验证”逻辑 #

首先得明确：DRF默认情况下不会对URL里的pk参数做主动的校验，它只是把这个参数原封不动地传给视图的get_object()方法，然后在ORM查询数据库的时候，才会触发隐式的类型校验：

• 如果你的模型主键是IntegerField，而URL传了非数字的字符串（比如/api/items/abc/），ORM尝试转换类型时会失败，抛出DoesNotExist异常，DRF会自动把这个异常转换成404响应。
• 如果主键是UUIDField，传了不符合UUID格式的字符串，同样会触发ORM查询失败，返回404。

本质上这不算DRF层面的参数验证，只是ORM查询时的自然结果，没有提前拦截无效参数。

二、无需内联代码的规范化校验方式 #

想要在视图外（或视图层面无内联代码）完成PK参数的校验，有几种优雅的方案：

1. 用Django原生路径转换器（最推荐） #

Django自带了多种路径转换器，能直接在路由层面校验PK的格式，不符合的请求会直接返回404，根本到不了视图：

• 整数类型主键：用int:转换器

  # urls.py
  from django.urls import path
  from .views import ItemRetrieveView
  
  urlpatterns = [
      path('items/<int:pk>/', ItemRetrieveView.as_view()),
  ]
  

• UUID类型主键：用uuid:转换器

  path('items/<uuid:pk>/', ItemRetrieveView.as_view()),
  

• 还有slug:、str:等转换器，对应不同的格式需求。

2. 自定义路径转换器 #

如果你的主键是特殊格式（比如固定长度的十六进制字符串），可以自己写一个转换器，注册后在路由里使用：

# 比如在app的utils/converters.py里
class HexPKConverter:
    # 定义匹配的正则表达式
    regex = '[0-9a-fA-F]{16}'

    def to_python(self, value):
        # 转换为Python对象（这里直接返回字符串即可）
        return value

    def to_url(self, value):
        # 转换为URL中的字符串
        return value

# 在urls.py里注册并使用
from django.urls import path, register_converter
from .utils.converters import HexPKConverter
from .views import ItemRetrieveView

register_converter(HexPKConverter, 'hexpk')

urlpatterns = [
    path('items/<hexpk:pk>/', ItemRetrieveView.as_view()),
]

3. 利用DRF视图的lookup_value_regex属性 #

DRF的通用视图（比如GenericAPIView、RetrieveAPIView）提供了lookup_value_regex属性，直接在视图类里定义PK的正则规则即可，不用写内联验证代码：

# views.py
from rest_framework.generics import RetrieveAPIView
from .models import Item
from .serializers import ItemSerializer

class ItemRetrieveView(RetrieveAPIView):
    queryset = Item.objects.all()
    serializer_class = ItemSerializer
    # 指定PK必须是16位十六进制字符串
    lookup_value_regex = '[0-9a-fA-F]{16}'

当URL中的PK不符合这个正则时，DRF会直接返回404响应。

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