Django 测试中 400 状态码错误排查与解决：常见陷阱与调试技巧-Python教程-PHP中文网

Django 测试中 400 状态码错误排查与解决：常见陷阱与调试技巧

本文旨在解决 django 测试中遇到的 400 状态码错误，特别是在手动操作成功而自动化测试失败的场景。核心原因通常是测试中使用的 api 端点不正确，或发送的请求数据字段与视图期望的表单字段不匹配。教程将指导读者如何排查这些问题，确保测试的准确性和可靠性，并提供实用的调试技巧与最佳实践。

在 Django 应用开发中，编写测试是确保代码质量和功能正确性的关键环节。然而，开发者有时会遇到测试失败并返回 400 状态码（Bad Request）的情况，尤其令人困惑的是，相同的功能通过手动操作却能正常工作。这种不一致性往往源于测试环境与实际运行环境的细微差异，特别是关于请求的 URL 和提交的数据结构。本教程将深入探讨导致 Django 测试返回 400 状态码的常见原因，并提供详细的排查步骤和解决方案。

核心问题诊断与解决方案

当 Django 测试返回 400 状态码时，通常意味着服务器未能理解客户端发送的请求。这在认证或表单提交场景中尤为常见，主要可归结为以下两个核心问题：API 端点不匹配和请求数据字段与表单期望不符。

1. API 端点不匹配

问题描述： 测试代码中 self.client.post() 方法使用的 URL 路径，与处理请求的视图函数实际绑定的 URL 模式不一致。即使手动访问 /login-form 成功，也可能只是触发了另一个视图，而测试期望调用的视图（例如 user_login）可能绑定在 /authentication/login/。如果测试指向了错误的 URL，或者目标 URL 不存在，都可能导致 400 错误（或 404 Not Found）。

用户示例分析： 在提供的案例中，用户手动登录时访问 /login-form，而测试代码中 self.client.post() 使用 /authentication/login/。虽然 user_login 视图可能确实绑定到 /authentication/login/，但任何 URL 上的不一致都可能导致问题。

解决方案：

仔细检查 urls.py 配置： 确认目标视图函数（例如 user_login）对应的准确 URL 模式。确保测试中使用的路径与 urls.py 中定义的路径完全一致。
使用 django.urls.reverse() 函数： 在测试中，强烈推荐使用 reverse() 函数来动态获取 URL。这不仅可以避免硬编码 URL 带来的错误，还能提高测试代码的可维护性，因为当 URL 模式发生变化时，只需更新 urls.py 而无需修改测试文件。

代码示例（修正后的测试代码）：

Feihong Word Docx

创建、检查和编辑 Microsoft Word 文档和 DOCX 文件，支持样式、编号、修订追踪、表格、分节及兼容性检查

下载

# authentication/urls.py 示例
from django.urls import path
from . import views

urlpatterns = [
    path('authentication/login/', views.user_login, name='user_login'),
    # path('login-form/', views.login_form_view, name='login_form'), # 假设存在另一个视图
]

# authentication/tests.py 修正后的测试代码
from django.test import TestCase
from django.urls import reverse
from django.contrib.auth.models import User

class AuthTestCase(TestCase):
    def setUp(self):
        # 在测试前创建测试用户，确保用户存在且活跃
        self.user = User.objects.create_user(username='voter1', email='voter1@example.com', password='123')
        self.user.is_active = True
        self.user.save()

    def test_login(self):
        # 使用 reverse() 获取正确的 URL
        login_url = reverse('user_login') # 假设 user_login 视图在 urls.py 中的 name 为 'user_login'

        # 确保数据字段与LoginForm期望一致 (详见下一节)
        data = {'usuario_email': 'voter1', 'password': '123'}
        response = self.client.post(login_url, data, format='json')

        # 调试输出，帮助排查问题
        if response.status_code != 200:
            print(f"Test failed with status code: {response.status_code}")
            try:
                print(f"Response JSON: {response.json()}")
            except ValueError:
                print(f"Response content: {response.content.decode()}")

        self.assertEqual(response.status_code, 200)
        message = response.json().get('message')
        self.assertEqual(message, 'Autentificacion correcta')

2. 请求数据字段与表单期望不符

问题描述： 这是导致 400 错误最常见的原因之一。当视图函数使用 django.forms.Form 或 django.forms.ModelForm 来处理 POST 请求时，self.client.post() 方法发送的 data 字典中的键名必须与表单类定义的字段名完全一致。如果表单期望一个名为 password 的字段，而测试发送了 password1，那么 form.is_valid() 将返回 False，导致视图返回 400 错误（通常是 JsonResponse({'error': 'Solicitud incorrecta'}, status=400)）。

用户示例分析： 用户提供的视图代码中，从 form.cleaned_data 中获取 password1 = cd.get('password1')。这暗示 LoginForm 可能有一个名为 password1 的字段。然而，在实际开发中，更常见的做法是使用 password 作为密码字段名。如果 LoginForm 定义了 password 字段，而测试发送 password1，那么表单验证就会失败。

解决方案：

检查 forms.py 中 LoginForm 的定义： 确认其所有字段的准确名称。
修改测试中的 data 字典： 使其键名与 LoginForm 的字段名保持一致。

代码示例（修正后的测试数据）：

# authentication/forms.py (假设 LoginForm 期望 'password' 字段)
from django import forms

class LoginForm(forms.Form):
    usuario_email = forms.CharField(label='Email/Username')
    password = forms.CharField(widget=forms.PasswordInput, label='Password') # 注意这里是 'password'

# authentication/tests.py 修正后的测试数据
# 原始测试数据: data = {'usuario_email': 'voter1', 'password1': '123'}
data = {'usuario_email': 'voter1', 'password': '123'} # 修正为匹配 LoginForm 的 'password' 字段

调试技巧与最佳实践

为了高效地定位和解决 400 状态码问题，以下调试技巧和最佳实践至关重要：

1. 视图层面的数据检查

在视图函数内部，特别是在处理 POST 请求的部分，添加打印语句来检查接收到的原始数据和表单验证结果。这能帮助你了解视图实际接收到了什么，以及表单为何验证失败。

# authentication/views.py (user_login 视图)
from django.http import JsonResponse
from django.contrib.auth import authenticate, login
from django.contrib.auth.models import User
from .forms import LoginForm # 确保导入了 LoginForm

def user_login(request):
    if request.method == 'POST':
        print(f"Received POST data: {request.POST}") # 打印原始 POST 数据
        form = LoginForm(request.POST)
        print(f"Form is valid: {form.is_valid()}") # 打印表单验证结果
        if not form.is_valid():
            print(f"Form errors: {form.errors}") # 如果验证失败，打印详细错误信息
            return JsonResponse({'error': '请求数据无效', 'details': form.errors}, status=400) # 返回更详细的错误信息

        cd = form.cleaned_data
        usuario_email = cd.get('usuario_email')
        password = cd.get('password') # 注意这里应与 LoginForm 字段名一致

        user = None
        if usuario_email and '@' in usuario_email: