Django单元测试中reverse生成带查询字符串URL报错问题排查

核心问题分析 #

你当前的问题源于路由配置、视图参数逻辑、测试代码写法三者完全不匹配：

1. 路由定义的是路径参数produce<str:code>（对应URL格式/produceabcd），但视图却从查询参数request.query_params获取code（对应/produce?code=abcd），两者逻辑冲突
2. reverse()函数不存在query_kwargs参数，改用kwargs后，参数会被当成路径参数传递，但你的视图并未接收路径参数，因此触发报错

解决方案步骤 #

1. 修正URL路由配置

由于视图是通过查询参数获取code，路由无需包含路径参数，修改为：

urlpatterns = [
    path('produce', ProduceSpreadSheet.as_view(), name="produce" ),
]

2. 修正测试代码

生成带查询参数的URL有两种简单实现方式：

方法一：手动拼接查询参数

from django.urls import reverse
from django.test import TestCase, Client
from rest_framework import status

class ProduceSpreadSheetTest(TestCase):
    def setUp(self):
        self.client = Client()
        self.code = "abcd"
        
    def test_valid_token(self):
        # 生成基础路径
        base_url = reverse('produce')
        # 拼接查询参数
        url = f"{base_url}?code={self.code}"
        response = self.client.get(url)
        self.assertEqual(response.status_code, status.HTTP_200_OK)

方法二：利用Django测试Client的data参数

Django测试Client的get()方法支持传入data参数，会自动转换为URL查询参数：

class ProduceSpreadSheetTest(TestCase):
    def setUp(self):
        self.client = Client()
        self.code = "abcd"
        
    def test_valid_token(self):
        url = reverse('produce')
        # 直接传入data，Client自动拼接为?code=abcd
        response = self.client.get(url, data={'code': self.code})
        self.assertEqual(response.status_code, status.HTTP_200_OK)

额外说明（若需改用路径参数） #

如果你的实际需求是使用路径参数（如/produce/abcd），需同步修改视图和路由：

• 路由调整为：path('produce/<str:code>', ProduceSpreadSheet.as_view(), name="produce" )
• 视图修改为接收路径参数：

class ProduceSpreadSheet(APIView):
   def get(self, request, code):
        # 直接使用路径传入的code参数
        # 后续逻辑

• 测试代码用reverse('produce', kwargs={'code': self.code})生成URL

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