第二章：模型 (Models) 与数据库

第二章：Django 模型与数据库设计指南

核心摘要：本章系统讲解 Django 模型（Models）作为数据结构蓝图的核心作用，深入解析模型定义规范、字段类型与约束选项、Meta 元数据配置、多数据库适配策略、迁移机制原理、CRUD 操作最佳实践、三种关系建模（一对一、一对多、多对多）以及模型方法封装技巧。内容覆盖开发全流程，兼顾可维护性、性能与安全性，是构建健壮 Django 应用的数据层基石。

2.1 模型：数据结构的蓝图

Django 模型是 Python 类，继承自 django.db.models.Model，直接映射数据库表结构。每个模型类对应一张数据库表，其属性对应表字段，而 Django ORM 负责将 Python 对象操作自动转换为高效、安全的 SQL 查询，实现数据库访问的抽象化与平台无关性。

2.1.1 模型定义规范

定义模型需继承 models.Model，并在类中声明字段。所有字段均为 django.db.models 模块中 Field 子类的实例，如 CharField、ForeignKey 等。字段命名应语义清晰，符合 PEP 8 规范。

以下为博客文章模型的标准实现：

from django.db import models
from django.utils import timezone

class Post(models.Model):
    title = models.CharField(max_length=200, verbose_name="标题")
    content = models.TextField(verbose_name="正文")
    pub_date = models.DateTimeField(
        verbose_name="发布日期",
        default=timezone.now,
        help_text="文章首次公开的时间"
    )
    
    def __str__(self):
        return self.title
    
    class Meta:
        verbose_name = "文章"
        verbose_name_plural = "文章管理"
        ordering = ["-pub_date"]
​

关键要点说明：

• verbose_name 提升 Django Admin 可读性，替代默认字段名；
• default=timezone.now 替代字符串 'date published'，避免时区歧义；
• help_text 提供上下文提示，增强表单用户体验；
• __str__ 方法返回可读字符串，是调试与后台显示的基础；
• Meta 类内聚元数据，提升模型可维护性。

2.1.2 核心字段类型与适用场景

Django 提供丰富字段类型，需根据数据语义、存储需求与查询模式精准选择：

字段选型原则：优先使用语义化字段（如 EmailField 而非 CharField），利用内置验证与数据库约束；对高并发写入场景，考虑 BigAutoField 替代默认 AutoField；涉及金额、比例等精确计算，必须使用 DecimalField。

2.1.3 字段选项：精细化数据约束

字段选项是保障数据质量与业务规则的关键层，需严格区分数据库层（null）与应用层（blank）约束：

2.1.4 Meta 类：模型元数据配置

Meta 类集中管理模型非字段行为，是提升可维护性与数据库性能的核心配置区：

class Post(models.Model):
    # 字段定义...
    
    class Meta:
        db_table = "blog_posts"                # 自定义表名（避免Django默认命名）
        ordering = ["-pub_date", "title"]      # 默认排序：先按发布时间降序，再按标题升序
        verbose_name = "文章"
        verbose_name_plural = "文章管理"
        indexes = [
            models.Index(fields=["pub_date", "status"]),  # 联合索引优化列表页查询
            models.Index(fields=["-pub_date"]),           # 单字段索引优化最新文章查询
        ]
        constraints = [
            models.CheckConstraint(
                check=models.Q(pub_date__lte=timezone.now()),
                name="post_pub_date_in_past"
            ),
        ]
        unique_together = [["title", "author"]]  # 联合唯一：同一作者不可发布同名文章
​

关键配置解析：

• db_table：显式声明表名，避免 Django 默认 app_model 命名与团队数据库规范冲突；
• ordering：定义 QuerySet 默认排序，影响 all()、filter() 等未显式排序的查询结果；
• indexes：替代已废弃的 index_together，支持表达式索引与部分索引（如 Index(fields=['status'], condition=Q(status='published'))）；
• constraints：在数据库层强制业务规则（如发布时间不能为未来），比 clean() 方法更可靠；
• unique_together：确保字段组合唯一性，比 unique=True 更灵活，适用于多字段约束。

2.2 数据库配置与多后端支持

Django 通过 settings.py 中的 DATABASES 配置字典支持 PostgreSQL、MySQL、SQLite、Oracle 等主流数据库。配置需兼顾安全性、性能与可移植性。

2.2.1 DATABASES 配置详解

# settings.py
import os
from decouple import config  # 推荐使用 python-decouple 管理敏感配置

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': config('DB_NAME', default='myapp'),
        'USER': config('DB_USER', default='myapp_user'),
        'PASSWORD': config('DB_PASSWORD', default=''),
        'HOST': config('DB_HOST', default='localhost'),
        'PORT': config('DB_PORT', default='5432'),
        'OPTIONS': {
            'connect_timeout': 10,
            'options': '-c search_path=myschema'  # 指定默认schema（PostgreSQL）
        },
        'TEST': {
            'NAME': 'test_myapp',  # 测试数据库名
        }
    }
}
​

安全与最佳实践：

• 敏感信息隔离：使用 python-decouple 或 django-environ 从 .env 文件读取 DB_PASSWORD、DB_USER，禁止硬编码；
• 连接超时设置：OPTIONS.connect_timeout 防止数据库宕机导致请求阻塞；
• 测试数据库隔离：TEST.NAME 明确指定测试库，避免污染开发数据；
• PostgreSQL Schema 支持：options 中设置 search_path，适配多 schema 架构；
• SQLite 开发配置：'NAME': BASE_DIR / 'db.sqlite3' 为默认配置，适用于快速原型开发。

2.2.2 数据库迁移：模型演进的版本控制

Django 迁移机制将模型变更转化为可版本化、可回滚的数据库 Schema 操作，是团队协作与生产环境稳定的核心保障。

迁移工作流图示

核心迁移命令与场景

迁移黄金法则：迁移文件是数据库 Schema 的唯一真相源，必须与 models.py 严格同步；禁止直接修改已提交的迁移文件；生产环境迁移需在低峰期执行，并监控慢查询日志。

2.3 模型操作：高效安全的 CRUD 实践

Django ORM 提供简洁 API，但需理解底层机制以规避 N+1 查询、事务异常等常见陷阱。

2.3.1 创建对象（Create）

# ✅ 推荐：批量创建（高效，减少数据库往返）
Post.objects.bulk_create([
    Post(title="Post 1", content="Content 1", pub_date=timezone.now()),
    Post(title="Post 2", content="Content 2", pub_date=timezone.now()),
])

# ✅ 推荐：创建并获取完整对象（触发信号、验证）
post = Post.objects.create(
    title="Django Models Guide",
    content="Comprehensive tutorial...",
    pub_date=timezone.now()
)

# ❌ 避免：先实例化再 save（额外开销）
post = Post(title="Title")  # 未赋值字段可能违反 not null 约束
post.save()  # 两次数据库操作
​

2.3.2 查询对象（Read）：性能与安全并重

高级查询技巧：

# ✅ 使用 select_related 预加载外键（1次SQL）
posts = Post.objects.select_related('author').filter(status='published')

# ✅ 使用 prefetch_related 预加载多对多（2次SQL）
posts = Post.objects.prefetch_related('tags').filter(status='published')

# ✅ 使用 annotate 聚合计算（避免Python层循环）
from django.db.models import Count, Avg
authors = Author.objects.annotate(
    post_count=Count('posts'),
    avg_rating=Avg('posts__rating')
)

# ✅ 使用 Q 对象构建复杂条件
from django.db.models import Q
posts = Post.objects.filter(
    Q(title__icontains='Django') | Q(content__icontains='ORM')
)
​

2.3.3 更新对象（Update）

# ✅ 推荐：批量更新（高效）
Post.objects.filter(
    pub_date__lt=timezone.now() - timedelta(days=365)
).update(status='archived')

# ✅ 推荐：单对象更新（安全）
post = Post.objects.get(pk=1)
post.status = 'published'
post.save()  # 触发 clean(), pre_save, post_save
​

2.3.4 删除对象（Delete）

生产环境删除准则：所有删除操作必须在事务中执行（transaction.atomic）；关键数据启用软删除（添加 is_deleted 字段）；批量删除前使用 count() 预估影响范围。

2.4 模型关系：构建健壮数据关联

关系建模是数据库设计核心，需根据业务语义选择恰当关系类型，并合理配置 on_delete 与 related_name。

2.4.1 一对一关系（OneToOneField）

典型场景：用户扩展信息、配置表、主从拆分。

from django.contrib.auth.models import User

class UserProfile(models.Model):
    user = models.OneToOneField(
        User,
        on_delete=models.CASCADE,  # 用户删除，资料同步删除
        related_name='profile',    # 反向查询：user.profile
        help_text="关联的用户账户"
    )
    avatar = models.ImageField(upload_to='avatars/', blank=True)
    bio = models.TextField(blank=True)
    
    def __str__(self):
        return f"{self.user.username}'s profile"
​

设计要点：

• on_delete=models.CASCADE：强一致性场景（如用户资料）；
• on_delete=models.SET_NULL：需保留历史记录（null=True 必配）；
• related_name 命名应体现业务语义（如 profile, settings, stats）。

2.4.2 一对多关系（ForeignKey）

典型场景：文章与作者、订单与用户、评论与文章。

class Author(models.Model):
    name = models.CharField(max_length=100)
    
    def __str__(self):
        return self.name

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey(
        Author,
        on_delete=models.PROTECT,  # 防止误删作者（存在书籍时禁止删除）
        related_name='books',      # 反向查询：author.books.all()
        verbose_name="作者"
    )
    
    def __str__(self):
        return self.title
​

关键配置：

• on_delete=models.PROTECT：核心业务实体（如作者、分类）禁用级联删除；
• on_delete=models.SET_DEFAULT：需设置 default= 参数，如 default=1（默认作者ID）；
• related_name 使用复数形式（books），符合 Django 惯例。

2.4.3 多对多关系（ManyToManyField）

典型场景：文章与标签、用户与权限、商品与分类。

class Tag(models.Model):
    name = models.CharField(max_length=50, unique=True)
    
    def __str__(self):
        return self.name

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey(Author, on_delete=models.PROTECT, related_name='books')
    tags = models.ManyToManyField(
        Tag,
        related_name='books',
        blank=True,
        verbose_name="标签"
    )
    
    def __str__(self):
        return self.title
​

高级用法：

• 自定义中间表（through）：当关联需存储额外属性（如 BookTag.weight）时：

  class BookTag(models.Model):
      book = models.ForeignKey(Book, on_delete=models.CASCADE)
      tag = models.ForeignKey(Tag, on_delete=models.CASCADE)
      weight = models.PositiveSmallIntegerField(default=1)  # 权重排序
  
  class Book(models.Model):
      # ...
      tags = models.ManyToManyField(Tag, through='BookTag')
  ​

• 反向查询优化：tag.books.all() 自动使用中间表索引，无需额外配置。

关系访问全景图

2.5 模型方法：封装业务逻辑

模型方法将领域逻辑内聚于数据层，提升代码可读性与复用性，避免业务逻辑散落在视图或模板中。

2.5.1 __str__ 与 __repr__：可调试性基石

class Post(models.Model):
    # 字段定义...
    
    def __str__(self):
        return f"{self.title} ({self.pub_date.strftime('%Y-%m-%d')})"
    
    def __repr__(self):
        return f"<Post id={self.pk} title='{self.title[:20]}...'>"
​

原则：__str__ 返回用户友好的简短描述（Admin 显示）；__repr__ 返回开发者友好的完整标识（调试日志）。

2.5.2 业务方法：可测试、可复用

from django.db import models
from django.utils import timezone

class Book(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey(Author, on_delete=models.PROTECT, related_name='books')
    publication_date = models.DateField()
    price = models.DecimalField(max_digits=8, decimal_places=2)
    
    def is_recent(self):
        """判断是否为近3年出版"""
        return (timezone.now().date() - self.publication_date).days <= 365 * 3
    
    def get_discounted_price(self, discount_rate=0.1):
        """计算折扣价"""
        if not 0 <= discount_rate <= 1:
            raise ValueError("Discount rate must be between 0 and 1")
        return round(self.price * (1 - discount_rate), 2)
    
    @property
    def age_in_years(self):
        """计算出版年限（只读属性）"""
        delta = timezone.now().date() - self.publication_date
        return delta.days // 365
    
    def save(self, *args, **kwargs):
        """重写 save 方法，添加业务规则"""
        if self.price < 0:
            raise ValueError("Price cannot be negative")
        super().save(*args, **kwargs)  # 调用父类 save
​

方法设计规范：

• 纯业务方法（如 is_recent）：无副作用，仅返回计算结果，便于单元测试；
• 带副作用方法（如 send_notification）：明确命名（send_, process_），避免隐式行为；
• @property：用于轻量级计算属性，避免数据库查询；
• 重写 save()：仅在必须干预保存流程时使用（如数据清洗、状态自动更新），需调用 super().save()。

2.6 本章总结：构建高质量 Django 数据层

Django 模型不仅是数据库表的映射，更是业务规则、数据约束与应用逻辑的统一载体。掌握本章核心要点，可系统性提升应用的数据层质量：

• 模型定义：遵循字段语义化、约束显式化、元数据内聚化原则；
• 数据库配置：通过环境变量隔离敏感信息，为生产环境配置连接池与超时；
• 迁移管理：将迁移视为数据库 Schema 的版本控制，严格遵循生成→审查→应用流程；
• CRUD 实践：善用 select_related/prefetch_related 规避 N+1 查询，区分单对象与批量操作场景；
• 关系建模：依据业务语义选择关系类型，on_delete 策略需匹配数据一致性要求；
• 模型方法：将领域逻辑封装于模型，提升代码可维护性与测试覆盖率。

进阶提示：生产环境应启用 Django Debug Toolbar 监控查询性能；对高频查询字段添加数据库索引；定期使用 python manage.py showmigrations 审计迁移状态；结合 django-sql-explorer 安全分析原始 SQL。

Django 模型是应用架构的基石。扎实掌握本章内容，将为后续视图、模板、表单及 REST API 开发奠定坚实的数据层基础，助力构建高性能、高可用、易维护的企业级 Web 应用。