Django Rest Framework结合Knox的受保护POST接口测试返回401排查
401未授权错误的核心触发原因
- 认证模型错配:测试中使用的Token来自DRF原生authtoken模块,与项目配置的Knox认证体系完全独立。Knox使用独立数据表存储认证凭证,原生DRF生成的Token不在Knox的校验逻辑覆盖范围内,直接被判定为非法凭证。
- Knox Token取值逻辑错误:Knox出于安全设计,数据库中仅存储Token内容的SHA哈希值,不保存明文。直接创建AuthToken实例后读取的
.key字段为哈希值,并非可用于认证的明文字符串,与请求携带的认证信息完全不匹配,必然触发校验失败。 - 认证头格式不规范:Knox的认证类默认识别
Bearer认证 scheme,而非原生Token方案使用的Tokenscheme,格式不匹配的认证头会被直接忽略。 - 用户创建参数错位:原有测试调用
create_user时将密码作为第二个位置参数传入,而Django用户管理器的方法签名中第二个位置参数为邮箱字段,导致创建的用户未设置有效密码,即使走Session登录流程也无法完成身份校验。 - 冗余认证逻辑冲突:测试中同时调用Django Session登录方法、手动设置Authorization头两套认证逻辑,当项目认证优先级配置为Knox优先时,两套逻辑的冲突会进一步提升认证失败的概率。
修正后的测试实现
调整逻辑完全对齐Knox的校验规则,删除冗余逻辑,核心调整方向包括:导入Knox官方AuthToken模型、正确生成明文凭据、按照Knox规范构造认证头、修正用户创建的参数传递。
from django.urls import reverse from rest_framework.test import APITestCase from knox.models import AuthToken from django.contrib.auth import get_user_model class addCardAPIViewTestCase(APITestCase): url = reverse("cards") def setUp(self): self.username = "john" self.email = "john@snow.com" self.password = "you_know_nothing" # 修正create_user的参数传递,正确设置用户的邮箱与密码 self.user = get_user_model().objects.create_user( username=self.username, email=self.email, password=self.password ) # 按Knox规范生成凭证,拿到可用于认证的明文字符串 self.token, self.token_record = AuthToken.objects.create(user=self.user) def test_create_cards(self): # 按Knox要求设置Bearer格式的认证头,删除冗余的Session登录调用 self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {self.token}') response = self.client.post( self.url, { "bank": "Citibank", "card_number": "5618073505538298", "owner_name": "c1", "cvv": "121", "expiry_date_month": "03", "expiry_date_year": "2023" }, format='json' ) self.assertEqual(response.status_code, 201) # 可补充业务校验,确认创建的卡片正确关联当前登录用户 self.assertEqual(response.data['card']['owner'], self.user.id)
注意:如果项目对Knox认证的scheme做了自定义修改,需要与
HTTP_AUTHORIZATION头的前缀保持一致,否则依然会触发401未授权错误。
内容的提问来源于stack exchange,提问作者Aditya Mahajan
相关产品推荐
相关产品推荐

