架构与系统设计 / 系统课时
复杂查询应该全部放 Repository 吗
复杂查询应该全部放 Repository 吗
Repository 的核心职责不是承接所有数据库查询,而是为领域行为提供聚合的获取与持久化边界。报表、列表、搜索这类读操作往往只需要投影后的数据,如果强行经由聚合加载,会让 Repository 接口膨胀,也增加不必要的对象重建成本。
学习目标
- 判断一个查询是否应该由 Repository 承担
- 区分“加载聚合执行业务行为”和“直接读取查询模型”两类需求
- 为列表、搜索和报表设计独立的读取接口
先看 Repository 要解决的问题
在 DDD 中,Repository 面向的是聚合,而不是表。应用服务需要执行业务行为时,先通过 Repository 取得完整或足够完整的聚合,再调用领域方法,最后保存聚合。
例如“确认订单”需要订单当前状态、订单项和金额规则,这类操作的重点是维护领域不变量。Repository 应提供诸如 findById、save 这样的聚合语义,而不是暴露几十个按页面字段拼接出来的查询方法。
相反,“运营后台搜索最近 30 天待发货订单,并展示客户名、商品数、应付金额”通常只是在读取数据。它不准备修改订单,也不需要构造完整 Order 聚合。此时让 Repository 返回一个为页面定制的 DTO,会逐渐把领域持久化接口变成通用查询中心。
用意图区分两条读取路径
可以用一个简单问题判断:查询结果是否马上用于执行领域行为,并且需要由聚合保护业务规则?
- 是:优先通过 Repository 加载聚合。
- 否:如果只是列表、搜索、报表、统计或导出,可以走独立的查询接口,直接返回读模型。
- 混合场景:先用查询模型筛出候选 ID,再按需要逐个加载聚合执行业务行为。

这种拆分并不要求一定采用完整 CQRS。即使仍使用同一个数据库,也可以让写侧 Repository 和读侧 Query Service 使用不同接口,只要职责边界清楚即可。
一个可运行的最小示例
下面的 Java 17 示例同时保留两条路径:OrderRepository 返回聚合,供领域行为使用;OrderQueryService 直接返回页面需要的 OrderRow。示例用内存数据模拟持久化,重点是接口职责而不是数据库框架。
import java.util.List;
import java.util.Map;
public class RepositoryQueryDemo {
record Order(String id, String status, int itemCount, int total) {
Order confirm() {
if (!status.equals("PENDING")) {
throw new IllegalStateException("order is not pending");
}
return new Order(id, "CONFIRMED", itemCount, total);
}
}
record OrderRow(String id, String status, int total) {}
// Repository 面向聚合生命周期,接口保持领域语义。
interface OrderRepository {
Order findById(String id);
void save(Order order);
}
// 查询接口直接返回读模型,不要求重建完整聚合。
interface OrderQueryService {
List<OrderRow> findPending();
}
static final class InMemoryStore implements OrderRepository, OrderQueryService {
private final Map<String, Order> data = new java.util.HashMap<>();
InMemoryStore() {
data.put("O-1001", new Order("O-1001", "PENDING", 2, 199));
data.put("O-1002", new Order("O-1002", "CONFIRMED", 1, 80));
}
public Order findById(String id) {
return data.get(id);
}
public void save(Order order) {
data.put(order.id(), order);
}
public List<OrderRow> findPending() {
// 这里只投影页面真正需要的字段。
return data.values().stream()
.filter(order -> order.status().equals("PENDING"))
.map(order -> new OrderRow(order.id(), order.status(), order.total()))
.toList();
}
}
public static void main(String[] args) {
InMemoryStore store = new InMemoryStore();
System.out.println(store.findPending());
// 发生状态变更时重新走聚合路径,让领域方法保护规则。
Order order = store.findById("O-1001");
store.save(order.confirm());
System.out.println(store.findById("O-1001").status());
}
}预期输出:
[OrderRow[id=O-1001, status=PENDING, total=199]]
CONFIRMED第一行只是查询页面需要的字段,因此没有重建更多领域结构;第二条路径先取得 Order,再通过 confirm() 执行业务规则并保存。
复杂查询放在哪里更合适
独立查询接口可以位于应用层定义,由基础设施层实现。实现时可以使用 SQL、JPA 投影、MyBatis、查询 DSL 或搜索引擎,但这些技术细节不应反向污染领域模型。
例如,一个订单列表查询需要联结订单、客户和物流表,排序后再分页。只要它的目的只是展示,就没有必要为了“遵守 Repository 模式”先分别加载多个聚合再在内存中拼装。直接查询出 OrderRow 往往更简单,也更容易优化索引与分页。
避免两个常见极端
把所有查询都塞进 Repository,会产生大量 findByXxxAndYyy 方法,让接口围绕页面筛选条件而不是聚合语义增长。反过来,如果所有读取都绕过 Repository,应用层又可能直接拿数据库行执行业务判断,导致领域规则散落在 SQL 和服务代码中。
更稳妥的边界是:Repository 服务于聚合生命周期与领域行为,查询服务服务于读取体验与投影模型。两者可以共享数据库,却不必共享同一种对象模型。