本文详细介绍了如何在 django 模型查询中结合使用 and 和 or 逻辑，以实现复杂的过滤条件。通过引入 django 的 `q` 对象，开发者可以构建清晰、可读性强的查询语句，有效处理如 `(条件a and (条件b or 条件c))` 这样的复合逻辑。文章还提供了具体代码示例和重要的开发实践建议，帮助读者优化查询性能和用户体验。
在 Django ORM 中进行数据库查询时，我们经常需要组合多个过滤条件。虽然简单的 filter() 方法可以处理多个 AND 条件，但当需要引入 OR 逻辑，尤其是 AND 和 OR 混合使用时，就需要借助 Django 提供的 Q 对象来构建复杂的查询表达式。
理解 Django Q 对象
Q 对象是 Django django.db.models 模块中的一个类，它允许我们将 SQL WHERE 子句中的各个条件封装成独立的 Python 对象。这些 Q 对象可以通过位运算符 &（表示逻辑 AND）和 |（表示逻辑 OR）进行组合，从而构建出任意复杂的查询逻辑。
例如，一个简单的 Q(field=value) 就代表一个过滤条件。当多个 Q 对象使用 & 或 | 组合时，Django ORM 会将其转换为相应的 SQL 表达式。
实现 AND 和 OR 混合查询
假设我们有一个 User 模型和一个 Dataset 模型，我们希望查询所有满足以下条件的 Dataset：
- 数据集的 type 字段为特定值（例如 1）。
- 并且 (数据集属于当前用户 usr 或者 不属于任何用户 (UserID 为空))。
这可以抽象为 (type = 1) AND (UserID = usr OR UserID IS NULL)。
以下是相关模型定义：
from django.db import models
from django.contrib.auth.models import AbstractUser
class User(AbstractUser):
username = models.CharField(max_length=150, unique=True)
first_name = models.CharField(blank=True, max_length=150)
last_name = models.CharField(blank=True, max_length=150)
class Dataset(models.Model):
name = models.CharField(null=False, unique=True, max_length=50)
type = models.PositiveIntegerField()
UserID = models.ForeignKey(
User,
null=True,
blank=True,
on_delete=models.CASCADE,
related_name="ds_owner",
)为了实现上述复杂的查询逻辑，我们可以使用 Q 对象来构建查询表达式。
方法一：明确的 Q 对象组合
这种方法将每个原子条件都封装在 Q 对象中，然后使用 & 和 | 进行组合，结构清晰，易于理解。
from django.db.models import Q
from django.shortcuts import get_object_or_404 # 推荐使用
def view_name(request):
# 安全地获取当前用户对象，避免500错误
usr = get_object_or_404(User, id=request.user.id)
# 构建复杂的查询条件
# (Q(type=1)) & (Q(UserID=usr) | Q(UserID__isnull=True))
allowed_datasets = Dataset.objects.filter(
Q(type=1) & (Q(UserID=usr) | Q(UserID__isnull=True))
)
# 可以在此处处理 allowed_datasets
return HttpResponse("...")在这个例子中：
- Q(type=1) 匹配 type 字段为 1 的数据集。
- Q(UserID=usr) 匹配 UserID 为当前用户 usr 的数据集。
- Q(UserID__isnull=True) 匹配 UserID 为空（即 NULL）的数据集。
- Q(UserID=usr) | Q(UserID__isnull=True) 组合了 UserID 的 OR 条件。
- 最外层的 & 将 type=1 的条件与 UserID 的复合条件进行 AND 组合。
方法二：利用 filter() 方法的隐式 AND
filter() 方法接受多个关键字参数，它们之间默认是 AND 关系。我们可以将 OR 条件封装在一个 Q 对象中，然后将其与其他 AND 条件作为独立的参数传递给 filter()。
from django.db.models import Q
from django.shortcuts import get_object_or_404 # 推荐使用
def view_name(request):
usr = get_object_or_404(User, id=request.user.id)
# 将 OR 条件封装在一个 Q 对象中
# Q(UserID=usr) | Q(UserID__isnull=True)
# 然后与 type=1 作为 filter() 的两个独立参数
allowed_datasets = Dataset.objects.filter(
Q(UserID=usr) | Q(UserID__isnull=True),
type=1
)
# 可以在此处处理 allowed_datasets
return HttpResponse("...")这种写法更为简洁，因为 type=1 被作为 filter() 的一个关键字参数，与 Q 对象表达式之间隐式地形成了 AND 关系。这两种方法在功能上是等效的，可以根据个人偏好和代码可读性选择。
注意事项与最佳实践
-
对象检索的安全性：get_object_or_404 与 get 在上面的示例中，我们使用了 get_object_or_404(User, id=request.user.id) 来获取用户对象。这比直接使用 User.objects.get(id=request.user.id) 更为健壮。
- get_object_or_404()：如果对象不存在，会抛出 Http404 异常，Django 会自动将其转换为 HTTP 404 Not Found 响应。这对于用户体验和安全性来说是更好的选择，因为它避免了暴露服务器内部错误。
- get()：如果对象不存在，会抛出 DoesNotExist 异常，这通常会导致 HTTP 500 Server Error。在生产环境中，这会给用户带来糟糕的体验，并可能暴露服务器的内部信息。 因此，在处理用户请求时，尤其是在视图函数中，强烈建议使用 get_object_or_404()。
查询性能Q 对象生成的 SQL 查询通常是高效的，因为它们直接映射到数据库的 WHERE 子句。然而，复杂的查询可能会影响数据库的索引使用。在设计复杂查询时，应考虑字段的索引情况，以确保查询性能。
代码可读性 虽然 Q 对象功能强大，但过度嵌套或过于复杂的 Q 对象表达式可能会降低代码的可读性。在构建查询时，应力求清晰和简洁，必要时可以拆分查询逻辑或添加注释。
总结
Django 的 Q 对象为开发者提供了在 ORM 层构建复杂查询表达式的能力，尤其是在需要同时使用 AND 和 OR 逻辑时显得尤为重要。通过将查询条件封装为可组合的对象，并利用 & 和 | 运算符，我们可以灵活地实现各种复杂的过滤需求。结合 get_object_or_404 等最佳实践，可以编写出既强大又健壮的 Django 应用程序。
