Django常见问题之模型

原创 已于 2025-05-09 11:09:57 修改 · 226 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#django #python #学习

于 2025-03-04 11:23:59 首次发布

一、同模型多外键引用冲突及解决方案

1.1 问题现象

当模型中出现多个字段引用同一个模型作为外键时（如下方代码示例），Django 会抛出 clash 冲突错误：

from django.db import models
from django.contrib.auth.models import User
from utile.model import timeFiledMixin, statusFiledMixin


class ProductTypeModel(timeFiledMixin.CreateTimeFiled, timeFiledMixin.UpdateTimeFiled,
                       models.Model):
    name = models.CharField(max_length=200, verbose_name='产品类型名称', db_index=True, unique=True)
    types = models.CharField(max_length=128, verbose_name='产品类型')

    class Meta:
        db_table = 'product_type'
        verbose_name = '产品类型'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name


class Products(timeFiledMixin.CreateAndUpdateTimeFiled, statusFiledMixin.ActiveFiled, models.Model):
    name = models.CharField(max_length=200, verbose_name='产品名称', db_index=True, unique=True)
    product_type = models.ForeignKey(ProductTypeModel, on_delete=models.CASCADE)
    introduction = models.CharField(max_length=255, verbose_name='产品介绍', blank=True, null=True)
    administrator = models.ManyToManyField(User)
    creator = models.ManyToManyField(User, verbose_name='创建者')

    class Meta:
        db_table = 'product'
        verbose_name = '产品'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name

模型Products字段 administrator 和 creator 同时引用 User 作为外键，导致运行异常

1.2 原因分析

Django 自动为关联字段创建的反向关系名称（related_name）默认采用 <model_name>_set 格式。当多个字段引用同一模型时，Django 无法自动区分反向关系名称，导致命名冲突。

1.3 解决方案

通过显式声明 related_name 参数为每个字段定义唯一反向关系名称：

分别添加 related_name 参数，分别自定义不同名称即可

1.4 使用规范与注意事项

  1. 命名规范：推荐使用 <app_label>_<model_name>_<field_name> 格式

    • 示例：products_product_administrators

  2. 查询关系：

     # 正向查询
 product = Products.objects.first()
 admins = product.administrator.all()
 ​
 # 反向查询（通过 related_name）
 user = User.objects.first()
 created_products = user.product_creators.all()

  3. 级联关系：使用 on_delete 参数明确删除行为（适用于 ForeignKey）

    • CASCADE：级联删除

    • PROTECT：阻止删除

    • SET_NULL：设为 NULL（需允许空值）

二、新增非空外键字段的默认值问题（You are trying to add a non-nullable field 'name' to contact without a default）

2.1 问题现象

当向已存在数据的模型中新增非空外键字段时，会触发 NOT NULL constraint 错误：

Products 模型已迁移，表格中已有数据，此时新增外键administrator，执行迁移时报错

class Products(timeFiledMixin.CreateAndUpdateTimeFiled, statusFiledMixin.ActiveFiled, models.Model):
    name = models.CharField(max_length=200, verbose_name='产品名称', db_index=True, unique=True)
    product_type = models.ForeignKey(ProductTypeModel, on_delete=models.CASCADE)
    introduction = models.CharField(max_length=255, verbose_name='产品介绍', blank=True, null=True)
    creator = models.ManyToManyField(User, verbose_name='创建者', related_name='creator')
    administrator = models.ForeignKey(User, related_name='administrator', on_delete=models.DO_NOTHING)

    class Meta:
        db_table = 'product'
        verbose_name = '产品'
        verbose_name_plural = verbose_name

    def __str__(self):
        return self.name

2.2 原因解析

数据库要求新增字段必须为现有记录提供默认值，但Django无法自动确定关联模型的默认值。

2.3 解决方案汇总

方案一：迁移时交互设置默认值

  1. 执行迁移命令：

     python manage.py makemigrations
 python manage.py migrate

  2. 当提示 Please select a fix: 时选择选项 1

  3. 输入有效的用户ID作为默认值（需确保该ID存在）

方案二：模型字段预设默认值
        在Products模型中外键creator字段添加defunct字段设置默认，再进行迁移即可

方案二：模型字段预设默认值

  1. 首次迁移允许空值：

     administrator = models.ForeignKey(
     User,
     on_delete=models.SET_NULL,
     null=True,
     blank=True
 )

  2. 执行数据填充脚本：

     # 在migrations中创建RunPython操作
 def init_administrators(apps, schema_editor):
     Product = apps.get_model('appname', 'Products')
     default_user = User.objects.get_or_create(username='admin')[0]
     for product in Product.objects.all():
         product.administrator = default_user
         product.save()

  3. 二次迁移移除空值约束：

     administrator = models.ForeignKey(
     User,
     on_delete=models.SET_NULL,
     null=False
 )

三、模型继承方式选择不当导致数据冗余

3.1 问题现象

  • 使用多表继承 (Meta: abstract = False) 导致生成过多数据表

  • 子类重复存储父类字段数据，产生冗余

  • 查询父类时产生不必要的 JOIN 操作

3.2 解决方案：合理选择继承模式

 # 抽象基类（字段不生成实际表）
 class BaseModel(models.Model):
     created_at = models.DateTimeField(auto_now_add=True)
     
     class Meta:
         abstract = True  # 核心配置
 ​
 class Product(BaseModel):
     name = models.CharField(max_length=100)
 ​
 # 代理模型（仅扩展行为）
 class FeaturedProduct(Product):
     class Meta:
         proxy = True  # 不生成新表
     
     def mark_featured(self):
         self.featured = True
         self.save()

四、N+1 查询性能问题

4.1 问题现象

 # 触发 N+1 查询
 products = Product.objects.all()
 for p in products:
     print(p.category.name)  # 每次循环执行新查询

4.2 优化方案：预加载关联数据

 # 单次查询解决外键
 products = Product.objects.select_related('category')
 ​
 # 预取多对多/反向关系
 products = Product.objects.prefetch_related('tags')
 ​
 # 复杂预取（自定义查询集）
 from django.db.models import Prefetch
 products = Product.objects.prefetch_aching_related(
     Prefetch('reviews', queryset=Review.objects.filter(rating__gt=3))

五、字段选项配置混淆

5.1 null vs blank 的区别

配置组合数据库约束表单验证典型场景
null=True允许 NULL不验证数值型可选字段
blank=True无影响允许空值表单中的可选输入项
同时设置允许 NULL允许空值完全可选字段

5.2 时间字段配置陷阱

 # 自动更新时间（适合最后修改时间）
 last_modified = models.DateTimeField(auto_now=True)
 ​
 # 仅首次设置时间（适合创建时间）
 created_at = models.DateTimeField(auto_now_add=True)
 ​
 # 重要提醒：设置auto_now/add后，字段不可手动编辑

六、信号使用不当导致性能问题

6.1 典型错误场景

  • 在 post_save 中执行耗时同步操作（如发送邮件）

  • 未正确断开信号导致重复触发

  • 信号处理中修改实例引发递归保存

6.2 最佳实践方案

 
from django.db.models.signals import post_save
 from django.dispatch import receiver
 from .tasks import send_welcome_email  # Celery 任务
 ​
 @receiver(post_save, sender=User)
 def user_created_handler(sender, instance, created, **kwargs):
     if created:
         # 异步处理耗时操作
         send_welcome_email.delay(instance.id)
         
     # 避免递归：检查字段变化
     if hasattr(instance, '_dirty'):
         return
     instance._dirty = True
     instance.save()

七、数据库索引配置优化

7.1 索引类型选择

索引方式适用场景示例代码
字段级索引高频查询的单个字段price = models.IntegerField(db_index=True)
组合索引多字段联合查询Meta: index_together = ['category', 'status']
条件索引部分数据高频访问Meta: indexes = [models.Index(fields=['name'], condition=Q(stock__gt=0))]

7.2 索引优化建议

  1. 读多写少的字段优先添加索引

  2. 避免在频繁更新的字段上建索引

  3. 使用 explain() 分析查询计划：

     Product.objects.filter(category=5).explain()

八、多数据库路由配置

8.1 错误现象

  • 模型未正确指定数据库导致写入默认库

  • 跨库关联查询引发 Foreign key mismatch 错误

8.2 正确配置示例

 # settings.py
 DATABASE_ROUTERS = ['path.to.ProductRouter']
 ​
 # routers.py
 class ProductRouter:
     def db_for_read(self, model, **hints):
         if model._meta.app_label == 'products':
             return 'products_db'
         return None
 ​
     def allow_relation(self, obj1, obj2, **hints):
         # 禁止跨库关联
         if obj1._meta.app_label == 'products' and obj2._meta.app_label != 'products':
             return False
         return None

九、文件上传配置安全漏洞

9.1 危险配置

 # models.py（漏洞示例）
 class UserProfile(models.Model):
     avatar = models.FileField(upload_to='/var/www/uploads')  # 绝对路径不安全

9.2 安全配置方案

 # 动态路径 + 文件名处理
 def user_directory_path(instance, filename):
     return f'users/{instance.user.id}/{hashlib.md5(filename.encode()).hexdigest()}.{filename.split(".")[-1]}'
 ​
 class UserProfile(models.Model):
     avatar = models.ImageField(
         upload_to=user_directory_path,
         validators=[FileExtensionValidator(allowed_extensions=['jpg', 'png'])]
     )
 ​
 # settings.py 配置媒体文件隔离
 MEDIA_ROOT = '/secure/media/'  # 禁止Web直接访问
 MEDIA_URL = '/internal/media/'

十、单元测试中的模型陷阱

10.1 常见问题

  • 测试数据库未正确隔离导致数据污染

  • 未使用 factory_boy 造成测试数据创建缓慢

  • 未清理临时文件导致存储空间耗尽

10.2 优化测试方案

 
# 使用事务加速测试
 from django.test import TransactionTestCase
 ​
 class ProductTest(TransactionTestCase):
     def test_inventory(self):
         with transaction.atomic():
             prod = Product.objects.create(name="Test")
             # 测试代码...
 ​
 # 使用工厂批量创建
 from factory.django import DjangoModelFactory
 class ProductFactory(DjangoModelFactory):
     class Meta:
         model = Product
     
     name = "Default Product"
     price = 100
 ​
 def test_bulk_operations(self):
     products = ProductFactory.create_batch(100)
Django模型中的字段和模型名显示为中文小技巧分享 Python
HackQuestR的博客
09-23 385
默认情况下，Django会使用模型字段和模型名的英文形式作为数据库表的字段和表名。然而，有时候我们希望在管理后台或其他地方以中文的形式显示字段和模型名，以便更好地与用户进行交互。本文将分享一些简单的技巧，来实现在Django模型中将字段和模型名显示为中文的方法。通过以上方法，我们可以轻松地在Django模型中将字段和模型名显示为中文。如果我们需要更复杂的逻辑来确定字段和模型名的显示方式，我们可以通过自定义方法来实现。通过使用自定义的方法，我们可以根据自己的需求灵活地确定字段和模型名的中文表示。
django models verbose_name 的作用
热门推荐
QWERTY55555的专栏
04-12 2万+
一、 verbose_name就是在后台显示对对应的名称，看图 对应后台字段如图
五、orm设计
lyzkks的博客
03-05 1252
到目前已经完成了留言板的前端功能，也就是一个简单的页面，后端的逻辑还没有实现，也就是与数据库的操作。 什么是ORM ORM即Object Relational Mapping，中文是：关系对象映射。它使用类的名称来对应数据库表名称，类的属性对应 数据库中的字段，类实例对应数据库中表的一行数据。 ORM相比原生sql的优势 在不用ORM的时候，原生sql可能需要这样写： ...
Django报错`TemplateDoesNotExist`的模板加载问题
最新发布
shejizuopin的博客
05-26 822
在Django开发中，TemplateDoesNotExist错误通常是由于模板文件路径配置错误、应用未注册、模板名称拼写错误或模板文件扩展名错误引起的。本文详细分析了这些错误的成因，并提供了相应的修复技巧，如正确配置模板路径、注册应用、检查模板名称拼写和扩展名等。此外，还提出了预防措施和最佳实践，如统一模板路径管理、使用版本控制、彻底测试等，以帮助开发者有效避免和解决此类错误。通过掌握这些技巧和养成良好的编程习惯，开发者可以更顺利地处理TemplateDoesNotExist错误，提高开发效率。
Django里的ModelForm组件
CHNMSCS
06-06 513
要想在 ModelForm 里对某一些 Field 添加 css 样式，可以这么操作。如果要想添加在数据库没有的field到前端页面，可以这么操作。添加了红色方框里的输入框。ModelForm组件。这样效果就呈现在下面。
Django模型-Meta选项
Python老吕的博客
06-04 1057
在使用这些选项时，需要确保你了解它们的作用和可能的影响，以避免产生意外的结果或错误。类是Django模型中的一个重要组件，它包含了一些非字段的选项，用于控制模型的元数据。选项用于指定模型对应的数据库表名。默认情况下，Django会根据模型的小写名称和应用的名称来自动生成表名。选项用于指定一个字段名，Django将使用这个字段的值来确定对象的最新性。在Django中，模型（Model）是数据的抽象，它定义了数据库中的表结构以及与之相关的行为。选项用于控制Django是否应该管理模型的数据库表的生命周期。
verbose_name_plural
mandy__的博客
07-21 227
class ContentCategory(BaseModel): name = models.CharField(max_length=50, verbose_name='名称') key = models.CharField(max_length=50, verbose_name='类别键名') class Meta: db_table = 't...
新人学习python的django框架常见问题总结
04-26
### 新人学习Python的Django框架常见问题总结 #### 一、项目创建后的常见问题及解决方案 ##### 1. 生成迁移文件 - **命令**：`python manage.py makemigrations` - **解释**：当你对模型进行了更改，并希望将这些...
解决Django中调用keras的模型出现的问题
09-18
然而，在Django中直接调用预训练的Keras模型可能会遇到一些问题，主要涉及到TensorFlow和Django运行环境的交互。本文将详细解释这些常见问题以及提供解决方案。 问题的根源在于Django与Keras/TensorFlow的工作方式...
django的ORM模型的实现原理
09-19
Django框架作为Python世界里最流行的Web开发框架之一，内置了一套强大的ORM系统，极大地提高了开发者的效率。 #### 二、ORM模型的核心概念 在深入了解Django ORM的工作原理之前，我们先来看看ORM的基本概念： 1. ...
django实现模型字段动态choice的操作
12-20
在Django框架中，动态实现模型字段`choice`的操作是一个常见的需求，特别是在需要根据用户角色或权限展示不同选项的情况下。以下将详细介绍如何在Django中完成这个任务。 首先，我们来看第一种实现方式： 1. **...
模型迁移错误常见问题”django.db.utils.InternalError: (1050, “Table ‘django_content_type’ already exists”)”
01-21
django迁移模型常见错误django.db.utils.InternalError: (1050, “Table ‘django_content_type’ already exists”)” 这个问题经常出现在迁移模型时报错，表示该表已经存在，说明之前进行过模型的迁移操作。 例如...
Django:StackedInline 的更友好的标题，用于通过模型自动生成?
11-28 374
在 Django 中，你可以使用 `verbose_name` 和 `verbose_name_plural` 来为 StackedInline 的标题设置更友好的名称。1. 首先，你需要在你的模型类中定义一个 Meta 类，并在其中使用 `verbose_name` 和 `verbose_name_plural` 属性。3. 如果你的模型有自定义的字符串表示方法，那么你可以重写这个方法来返回一个更友好的名称。6. 如果你的模型有自定义的字符串表示方法，那么你可以重写这个方法来返回一个更友好的名称。
2Django pycharm
q386538588的博客
01-09 301
一、用pycharm运行django项目突然出错，找不到库，库文件也有问题，不知道为什么，可能是新建了项目冲突了。于是重新创建django项目，创建的时候选择新的anaconda环境。 在tool里面选择run mannag.py 运行startapp创建应用，然后运行。 二、Django模型之Meta选项详解 1.verbose_name verbose_name的意思很简单，就是给你的模型类起...
models
leshen_88的博客
03-24 2272
Django models 的字段类型 1、models.AutoField —自增列 = int(11) 如果没有的话，默认会生成一个名称为 id 的列，如果要显示的自定义一个自增列，必须将给列设置为主键 primary_key=True。 2、models.CharField —字符串字段 单行输入，用于较短的字符串，如要保存大量文本, 使用 TextField。必须 max_length 参数，django会根据这个参数在数据库层和校验层限制该字段所允许的最大字符数。 3、models
Django 模型（model）
Linxiaokang_1212的博客
11-19 7878
在当代 Web 应用中，主观逻辑经常牵涉到与数据库的交互。数据库驱动网站在后台连接数据库服务器，从中取出一些数据，然后在 Web 页面用漂亮的格式展示这些数据。
使用Python Django开发时遇到的问题
Mr_Joer的博客
04-21 1249
模型类中条件查询filter返回值问题 将表单传来的key值作为数据表title字段的查询条件 即使数据库中符合条件的只有一行数据，最外层也会有一个QuerySet类数组来包裹。即list不是Message类，需要list[0]将Message取出，如果需要输出查询的数据title字段的值，就（Message类中定义了title属性） 获取到类名list[0]后，访问属性值就不言而喻了。 ...
django面试常见问题
11-20
Django是一个流行的高级Python Web框架，用于快速开发安全、可维护的网站。在面试中关于Django的一些常见问题包括： 1. **基础概念**：你会如何描述Django的核心组件（如模型、视图、模板等）以及它们的作用？ 2. **ORM的理解**：Django ORM是如何工作的？它支持哪些数据库操作，例如CRUD（Create, Read, Update, Delete）？ 3. **MVC模式**：Django是如何体现Model-View-Controller设计模式的？ 4. **URL routing**：怎么配置Django路由以映射URL到相应的视图函数？ 5. **模板系统**：能否解释一下Django模板语言（Template Language）的基本语法和常用标签？ 6. **模板继承与模板过滤器**：模板继承如何帮助组织复杂的页面结构？常用的过滤器有哪些？ 7. **中间件（Middleware）**：Django中间件的工作原理及用途是什么？ 8. **文件上传处理**：Django的文件上传功能是如何管理的？ 9. **单元测试和Django测试客户端**：如何编写测试并使用测试客户端进行模拟HTTP请求？ 10. **性能优化**：你对Django的性能瓶颈有何认识，如何提升应用性能？
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Yant224

点滴鼓励，汇成前行星光🌟

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值