Django报错：视图收到意外关键字参数'pzn'问题排查

报错fachbereich_detailview() got an unexpected keyword argument 'pzn'的核心原因是：Django路由系统已经正确解析出路径参数，试图以关键字参数形式传给视图，但实际被调用的视图对象没有定义对应形参。
你修改URL规则里的参数名为test时，报错同步变为提示收到意外参数test，已经可以排除路由配置、模板反解的问题，故障点在视图侧，90%以上概率为以下两种情况：

• 视图挂载的自定义装饰器未正确转发参数
• 视图被同名函数/错误导入覆盖

1. 优先排查自定义装饰器问题 #

这是该报错最高发的场景：如果你给fachbereich_detailview加了自己写的登录校验、权限校验类装饰器，很可能装饰器的内部包装函数只接收了request参数，没有预留其他参数的接收位，也没有把参数转发给原视图。
错误装饰器示例：

# 错误写法：包装函数只接request，不接收/转发额外参数
def auth_check(view_func):
    def wrapper(request):
        if not request.user.is_authenticated:
            return redirect('login')
        return view_func(request)
    return wrapper

这种写法下，路由实际调用的是装饰器返回的wrapper函数，不管你原视图有没有写pzn形参，只要传了额外关键字参数就会抛错。
排查方法：临时注释掉视图上所有自定义装饰器，重启服务访问页面，如果报错消失即可定位问题。
修复装饰器写法，给包装函数加上可变参数，调用原视图时原样转发，同时用wraps保留原函数元信息：

from functools import wraps

def auth_check(view_func):
    @wraps(view_func)
    def wrapper(request, *args, **kwargs):
        if not request.user.is_authenticated:
            return redirect('login')
        # 接收所有额外参数，原样传给原视图
        return view_func(request, *args, **kwargs)
    return wrapper

2. 排查视图导入/覆盖问题 #

如果注释装饰器后报错依旧存在，说明实际调用的不是你贴出来的这个视图函数：

• 在你贴的fachbereich_detailview函数第一行加打印语句print("命中正确视图")，访问对应路径看控制台是否输出该内容
• 如果没有输出，检查urls.py里的视图导入路径是否正确，排查views.py里是否存在重名的旧函数、是否有其他模块导入的同名函数覆盖了当前视图

3. 修复隐藏的路由类型不匹配问题 #

核心报错修复后，你还需要调整路由转换器：你在Django shell中用字符串类型的pzn值"existingpzn"可以查询到数据，说明Products模型的pzn字段是字符串类型，但你当前路由用了<int:pzn>，仅匹配纯数字路径段：

• 如果pzn包含字母、特殊字符、前导零，路由会直接匹配失败返回404
• 就算pzn是纯数字，路由解析后会传整数类型值给视图，查询字符串类型字段时会出现前导零丢失、匹配失败的问题
  把路由规则的转换器改成<str:pzn>即可：

path('Produkt/<str:pzn>/', views.fachbereich_detailview, name='fachbereich_detailview'),

你当前视图里用了裸except捕获所有异常，会把语法错误、字段不存在等非预期异常也当成“产品不存在”处理，不利于后续排查问题，建议指定捕获的异常类型，或者直接用Django内置的快捷函数：

# 推荐写法：不存在直接返回404，省略冗余try except
from django.shortcuts import get_object_or_404
def fachbereich_detailview(request, pzn):
    context = {}
    product = get_object_or_404(Products, pzn=pzn)
    context['product'] = product
    return render(request, 'app/LoginArea/fachbereich_detailview.html', context)

# 如果你需要自定义跳转逻辑，就指定捕获DoesNotExist异常
from django.core.exceptions import ObjectDoesNotExist
def fachbereich_detailview(request, pzn):
    context = {}
    try:
        product = Products.objects.get(pzn=pzn)
    except ObjectDoesNotExist:
        return redirect('fachbereich')
    context['product'] = product
    return render(request, 'app/LoginArea/fachbereich_detailview.html', context)

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