Django：多对多字段返回空查询集但实际数据不为空

看起来你遇到了个有点挠头的问题：明明Django管理界面里admins字段显示有数据，但在shell里查询却返回空的QuerySet。我来帮你梳理几个常见的排查方向和解决办法：

1. 先排除对象缓存的坑 #

Django ORM会自动缓存查询到的对象，如果你是在添加admin用户之后才启动的shell，或者之前已经获取过account对象，那当前的account实例可能还是旧的缓存数据。试试刷新对象再查询：

>>> account = Account.objects.get(id=1)
>>> account.refresh_from_db()  # 强制从数据库重新加载最新数据
>>> print(account.admins.all())

如果这时候能查到数据，那就是缓存搞的鬼，问题直接解决。

2. 检查数据库中间表的实际数据 #

多对多关系会自动生成一张中间表（默认命名规则是[app名]_[模型名]_[字段名]，比如你的应该是account_admins），我们可以直接查看这张表的记录：

• 用数据库客户端（比如pgAdmin、MySQL Workbench）连接数据库，查询account_admins表，看是否存在account_id=1的记录，并且对应的accountuser_id是有效的用户ID。
• 或者在shell里直接执行SQL查询：

from django.db import connection
with connection.cursor() as cursor:
    cursor.execute("SELECT * FROM account_admins WHERE account_id = %s", [1])
    print(cursor.fetchall())

如果中间表里没有数据，那可能是admin的操作没成功提交（比如遇到了隐藏异常）；如果有数据但ORM查不到，就要往模型定义的方向排查了。

3. 验证模型关联的正确性 #

再核对下admins字段的定义：

admins = models.ManyToManyField('AccountUser', related_name='+', blank=True)

• 确认'AccountUser'这个模型名称拼写正确，如果AccountUser在其他app下，应该写成'otherapp.AccountUser'的完整形式，不然Django可能找不到对应的模型。
• related_name='+'只是禁用了反向关联查询，完全不影响正向的account.admins.all()查询，所以这个参数不是问题所在。

4. 检查关联模型的自定义管理器 #

如果AccountUser模型自定义了objects管理器，并且加了默认过滤条件（比如软删除逻辑），可能会导致多对多查询时被过滤掉。比如AccountUser有这样的管理器：

class AccountUserManager(models.Manager):
    def get_queryset(self):
        return super().get_queryset().filter(is_deleted=False)

那如果被关联的用户被标记为is_deleted=True，ORM查询时就会被排除，但Django admin可能显示了所有用户（包括已删除的）。你可以直接查询AccountUser验证：

>>> AccountUser.objects.filter(id=[你在admin里看到的用户ID])

5. 确认数据库读写一致性 #

如果你的项目配置了读写分离，可能存在admin的写操作（添加用户）落到主库，但shell的读操作走了从库，而从库还没同步主库的数据。这种情况下，可以尝试直接从主库查询，或者等同步完成后再试。

先从最简单的刷新对象开始排查，大概率能解决问题。如果还是不行，再一步步检查后面的点。

内容的提问来源于stack exchange，提问作者Dino