Django路由传入非合法UUID格式token触发ValidationError,如何捕获处理?
可行解决思路
- 调整URL路由的参数转换器类型,从根源上避免路由层提前抛错
当前报错的触发原因通常有两类:- 路由配置中给
stream/路径下的token参数绑定了Django内置的uuid类型转换器(路由写法类似path('stream/<uuid:token>/', stream)),这种配置下只要传入的字符串不符合UUID格式,系统会在路由匹配阶段直接抛出ValidationError,请求根本不会进入你写的视图函数。 - 你定义的
Creador模型中,stream_token字段本身被设置为UUID类型,当执行Creador.objects.filter(stream_token=token)查询时,如果传入的token不符合UUID格式,Django的ORM层会在生成数据库查询语句之前就抛出ValidationError,根本不会走到后续的分支判断。
对应调整方式是把路由里的参数转换器改成通用字符串类型,将路由写法修改为path('stream/<str:token>/', stream)。调整后无论传入什么格式的字符串,请求都会正常进入视图,不会在路由层被校验逻辑提前拦截。
- 路由配置中给
- 在视图层补全格式校验逻辑,统一处理不合法的token请求
当参数可以正常进入视图后,可以在执行数据库查询之前,先对token的格式做合法性校验,把格式不合法的请求和不存在的token做同一处理,避免触发ORM层的格式校验报错。
示例修改后的视图代码:from django.utils.uuid_utils import is_uuid def stream(request, token): # 先校验token格式,不合法直接返回不存在提示 if not is_uuid(token): return HttpResponse("Token no existe") user = Creador.objects.filter(stream_token=token).first() if user: return render(request, 'app1/stream.html', { 'token':token, 'user':user }) else: return HttpResponse("Token no existe") - 配置全局异常捕获逻辑,兜底处理校验类报错
如果不想修改原有路由和视图的配置,可以通过自定义中间件、配置Django全局错误处理器的方式,统一捕获路由层、视图层、ORM层抛出的ValidationError类异常。捕获后对异常内容做判断,确认是UUID格式不合法的场景时,直接返回自定义的友好提示(比如带400状态码的参数不合法提示),既不用暴露系统默认的错误堆栈,也不会影响原有业务的校验逻辑。 - 自定义路由参数转换器,替代内置UUID转换器
可以基于Django的路径转换器机制,开发自定义的UUID参数转换器,在参数不匹配格式规则的时候,不直接抛出ValidationError,而是将请求引导到专门的参数错误处理视图。这种方式可以完全可控的处理不合法的token访问请求,和内置转换器的区别是不会在路由匹配阶段直接中断请求流程。
内容的提问来源于stack exchange,提问作者deloco
相关产品推荐
相关产品推荐

