Tortoise ORM 中多对多关系查询排序问题解析

在使用 Tortoise ORM 进行多对多关系查询时，开发者可能会遇到返回结果排序不符合预期的情况。本文将通过一个典型场景，深入分析问题原因并提供解决方案。

问题现象

当使用 prefetch_related 方法查询多对多关系时，返回的数据顺序可能出现混乱。例如，在查询 Personx 模型与 Messagex 模型的多对多关系时，返回的 id 序列不是预期的升序排列，而是出现了类似 161, 162, 163... 这样看似随机的顺序。

根本原因

1. 数据库默认排序行为：大多数关系型数据库（包括PostgreSQL）不保证未指定排序条件的查询结果顺序。数据库可能基于查询优化策略返回不同顺序的结果。

2. ORM 设计原则：Tortoise ORM 作为轻量级ORM工具，遵循"显式优于隐式"的原则，不会自动添加未指定的排序条件。

3. 多对多中间表影响：多对多关系通过中间表实现，查询时涉及多表连接，进一步增加了结果顺序的不确定性。

解决方案

方法一：使用 Prefetch 显式指定排序

from tortoise.query_utils import Prefetch

data = await Personx.get(id=id).prefetch_related(
    Prefetch("msgx", queryset=Messagex.all().order_by("id"))
)

方法二：模型 Meta 中定义默认排序

class Messagex(Model):
    # 字段定义...
    
    class Meta:
        ordering = ["id"]  # 默认升序排列
        # ordering = ["-id"]  # 如需降序排列

方法三：结果集后处理（不推荐）

虽然可以在获取结果后使用Python排序，但这种方法效率较低，特别是数据量大时：

data = await Personx.get(id=id).prefetch_related("msgx")
sorted_msgs = sorted(data.msgx, key=lambda x: x.id)

最佳实践建议

1. 始终显式指定排序：即使当前数据库版本返回有序结果，也不应依赖这一行为，因为数据库升级或查询计划变化可能导致顺序改变。

2. 考虑索引影响：对经常排序的字段建立索引可以显著提高查询性能。

3. 分页查询优化：当处理大量数据时，结合排序和limit/offset实现高效分页。

4. 测试验证：在不同数据量和数据库版本下验证排序行为，确保系统稳定性。

总结

Tortoise ORM 作为Python异步ORM工具，为开发者提供了灵活的数据访问方式。理解数据库查询的基本原理和ORM的工作机制，能够帮助开发者避免类似排序问题。在多对多关系查询中，显式指定排序条件是最可靠的做法，这不仅是Tortoise ORM的最佳实践，也是使用任何ORM工具的通用原则。