Django模板反向解析带参路由报NoReverseMatch错误如何解决

报错核心原因是路由定义语法、模板标签、视图逻辑三处存在不匹配，按以下步骤修改即可正常跳转。

1. 修正urls.py路由配置 #

当前路由使用re_path定义，但<host_id>是path()方法专属的路径参数语法，re_path无法识别该占位符，导致反向解析时匹配不到路由。直接替换为path写法，同时明确参数类型、补全路由名和末尾斜杠：

from django.urls import path
from . import views

urlpatterns = [
    path('home/', views.home, name='home'),
    path('host-detailed/', views.host_detailed, name='host_detailed'),
    path('update/<int:host_id>/', views.update, name='update'),
]

Django默认开启APPEND_SLASH配置，路由末尾不加斜杠会触发301二次跳转，统一加上斜杠避免异常。

2. 修正模板a标签语法 #

现有a标签缺少href属性的闭合尖括号，标签结构不合法，且链接文本放在标签外部无法点击；同时外键字段取值容易出现混淆，直接使用Beacon模型主键传参即可：

{% for beacon in hosts %}
<tr>
    <td>{{ beacon.host_id }}</td>
    <td>{{ beacon.hostname }}</td>
    <td>{{ beacon.internalIp }}</td>
    <td>{{ beacon.externalIp }}</td>
    <td>{{ beacon.current_user }}</td>
    <td>{{ beacon.os }}</td>
    <td>{{ beacon.admin }}</td>
    <td><a href="{% url 'update' beacon.pk %}">Issue Command</a></td>
</tr>
{% endfor %}

3. 修正视图层逻辑 #

现有视图存在两个逻辑错误：一是传入的主机id对应Beacon模型主键，不能直接用来查询Command_Node的主键；二是redirect方法需要传入路由名，不能直接写模板文件名。修正后代码：

from django.shortcuts import render, redirect, get_object_or_404
from .models import Beacon, Command_Node

def home(request):
    hosts = Beacon.objects.all()
    return render(request, 'home.html', {'hosts': hosts})

def host_detailed(request):
    return render(request, 'hosts-detailed.html')

def update(request, host_id):
    host = get_object_or_404(Beacon, pk=host_id)
    # 不存在关联的Command_Node时自动创建，避免查询报错
    command_node, _ = Command_Node.objects.get_or_create(host_id=host)
    form = Command_Node(request.POST or None, instance=command_node)
    if form.is_valid():
        form.save()
        return redirect('home')
    return render(request, 'update.html', {'host': host, 'form': form})

修改完成后重启Django开发服务，点击表格中的Issue Command链接即可正常跳转到对应host_id的更新页面，不会再触发NoReverseMatch错误。

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