你如何测试 Django 应用程序？

Question

你如何测试 Django 应用程序？

Accepted Answer

Django 包含一个**内置的测试框架**（扩展 Python 的 `unittest`），其中包含为 Web 应用程序量身定制的工具——用于模拟请求的测试客户端、创建隔离测试数据库的 fixtures/database 系统，以及用于测试模型、视图和表单的助手。

## 基本测试用例

```python
from django.test import TestCase

class ArticleModelTest(TestCase):
    def setUp(self):
        # runs before each test; data created here is rolled back after
        self.article = Article.objects.create(title="Test", body="...")

def test_str(self):
        self.assertEqual(str(self.article), "Test")

def test_default_published(self):
        self.assertFalse(self.article.published)
```

`TestCase` 将每个测试包装在一个**随后回滚的数据库事务中**，因此测试是隔离的，不会相互污染——它使用一个**单独的测试数据库**（自动创建/销毁），永远不会影响你的真实数据。

## 使用测试客户端测试视图

```python
class ArticleViewTest(TestCase):
    def test_list_view(self):
        Article.objects.create(title="Hello")
        response = self.client.get("/articles/")        # simulate a GET request
        self.assertEqual(response.status_code, 200)
        self.assertContains(response, "Hello")           # the title appears in the HTML

def test_create_requires_login(self):
        response = self.client.post("/articles/create/", {"title": "X"})
        self.assertEqual(response.status_code, 302)      # redirected to login

def test_authenticated_create(self):
        self.client.login(username="ann", password="pw")  # log in for the test
        response = self.client.post("/articles/create/", {"title": "New", "body": "..."})
        self.assertEqual(Article.objects.count(), 1)
```

**测试客户端**模拟向你的视图发送 HTTP 请求（GET/POST、登录、会话等）而无需运行服务器——让你可以测试完整的请求/响应流程、状态代码和呈现的内容。

## 测试 DRF APIs

```python
from rest_framework.test import APITestCase

class ArticleAPITest(APITestCase):
    def test_create_article(self):
        response = self.client.post("/api/articles/", {"title": "X", "body": "..."}, format="json")
        self.assertEqual(response.status_code, 201)
        self.assertEqual(response.data["title"], "X")
```

## 有用的工具和实践

```text
✓ setUpTestData — create shared read-only data ONCE per class (faster than setUp)
✓ Factories (factory_boy) — generate test data cleanly instead of manual creation
✓ pytest-django — many teams prefer pytest's cleaner syntax over unittest
✓ Coverage.py — measure test coverage
✓ Mock external services (APIs, email) so tests are fast and deterministic
✓ Run: python manage.py test  (or pytest)
```

## 测试的内容

```text
Models → custom methods, validation, properties
Views  → status codes, correct data, permissions/auth, form handling
Forms/Serializers → validation logic (valid + invalid cases)
Business logic → the core domain rules
```

## 为什么这很重要

测试对于构建可靠、易维护的 Django 应用程序至关重要，而 Django 的内置测试框架——特别是为 Web 应用程序量身定制的——使其易于使用且高效，所以理解它对代码质量和专业标准都很重要。

该框架提供了 Web 特定的工具，使测试 Django 应用程序变得实用：**测试客户端**模拟向视图发送 HTTP 请求（处理 GET/POST、身份验证、会话），因此你可以测试完整的请求/响应流程——状态代码、呈现的内容、重定向、权限——无需运行服务器，这至关重要，因为视图是应用程序行为的关键所在。

**自动测试数据库**（新建后销毁，每个测试都包装在回滚的事务中）确保测试是隔离的，永远不会接触真实数据，使它们安全且可重复。

Understanding how to test the key layers — **models** (custom methods, validation)、**视图**（状态代码、数据、身份验证/权限、通过测试客户端处理表单）、**表单/序列化器**（有效和无效输入的验证逻辑）和**业务逻辑**——涵盖了测试 Django 应用程序的实际范围，而了解用于 DRF API 的 `APITestCase`、用于高效测试数据的 `setUpTestData`/factories 以及为快速确定性测试模拟外部服务等工具反映了成熟的测试实践。

经过充分测试的 Django 应用程序能够捕获回归，支持自信的重构，并记录预期的行为，而该框架的 Web 感知设计（特别是测试客户端和测试数据库）使彻底的测试远比自己实现要容易得多。

由于测试是专业软件开发的基础，而 Django 提供了针对其功能量身定制的优秀内置支持，所以知道如何在模型/视图/表单层中编写有效的测试很重要，这是一个经常相关的知识，它区分了构建健壮、易维护应用程序的开发人员和那些发布脆弱、未测试代码的开发人员。