当前位置：首页 > backend >正文

Django get_or_create 方法详解

backend 2025/9/6 0:59:07

get_or_create 是 Django ORM 中的一个非常常用的方法，它用于获取数据库中的一个对象，如果该对象不存在，则创建一个新的对象并返回。

方法签名：

Model.objects.get_or_create(defaults=None, **kwargs)

参数解释：

defaults（可选）：一个字典，包含在创建对象时要设置的字段。如果对象不存在，Django 会使用这些默认值来创建对象。如果未提供，Django 会使用模型的字段定义中的默认值（如果有的话）。
**kwargs：这是查询条件，用于根据字段值查找现有对象。如果数据库中存在符合这些条件的对象，它会返回该对象，否则会创建一个新的对象。

返回值：

对象：查询到的对象（或新创建的对象）。
布尔值：
- 如果返回的是 True，说明是通过创建操作返回的对象。
- 如果返回的是 False，说明是查询操作返回的已有对象。

使用场景：

get_or_create 方法非常适合在你需要确保某个对象存在时使用。它能够避免重复数据的插入，并简化代码。

基本示例：

假设你有一个 User 模型，里面有 username 和 email 字段，你希望确保某个用户名不存在时可以创建新用户，或者如果已存在则获取现有的用户。

模型定义：

from django.db import modelsclass User(models.Model):username = models.CharField(max_length=100, unique=True)email = models.EmailField(unique=True)def __str__(self):return self.username

使用 `get_or_create`：

# 假设我们要查找用户名为 "johndoe" 的用户，如果不存在，则创建这个用户
user, created = User.objects.get_or_create(username="johndoe",defaults={"email": "johndoe@example.com"}
)# 如果用户存在，'created' 为 False
# 如果用户是新创建的，'created' 为 Trueif created:print("用户已创建")
else:print("用户已存在")

返回值：

user: 这是你查询或新创建的 User 实例。
created: 布尔值，表示是否创建了新用户。如果用户已经存在于数据库中，created 为 False；如果新创建了用户，created 为 True。

默认值的使用：

defaults 参数的字典可以用来提供创建新对象时使用的默认值。注意，如果 defaults 参数未提供，而查询的对象在数据库中找不到，Django 会使用模型中字段的 default 值（如果有的话）进行创建。

# 假设我们不传递 email，模型定义了该字段的默认值
user, created = User.objects.get_or_create(username="janedoe"
)

在上面的例子中，email 字段如果模型中定义了默认值，会使用默认值来创建新用户。如果没有定义默认值，Django 会抛出一个 IntegrityError，因为 email 字段是 unique 的并且不能为空。

进阶使用：

get_or_create 可以处理一些更复杂的查询，包含多字段的查询条件。例如：

# 根据多个条件获取或创建对象
product, created = Product.objects.get_or_create(name="Laptop",price=1000.00,defaults={"description": "A high-end laptop"}
)

这里 Product 表格会根据 name 和 price 进行查询，如果没有匹配到记录，就会创建一个新对象，并使用 defaults 提供的 description 字段。

注意事项：

事务安全性：虽然 get_or_create 是一个原子操作，但它并不是事务安全的。这意味着如果有多个并发的请求尝试同时创建相同的对象，可能会出现竞争条件。在高并发场景下，最好使用事务来确保数据一致性。

可以通过以下方式手动处理：
```
from django.db import transactionwith transaction.atomic():user, created = User.objects.get_or_create(username="johndoe")
```
异常处理：如果 get_or_create 查询条件中有唯一约束，且多个实例插入相同的约束条件时，可能会引发 IntegrityError。在这种情况下，处理异常是非常重要的。