Spring Data MongoDB 在聚合管道中对数组字段（如 activeItems、activeTables）执行投影时，若源字段本身依赖于动态关联（如 $lookup 后的嵌套数组），直接使用 andExpression 或 Map 操作可能导致测试环境返回空数组——根本原因在于测试数据未触发实际的集合关联计算。
spring data mongodb 在聚合管道中对数组字段（如 `activeitems`、`activetables`）执行投影时，若源字段本身依赖于动态关联（如 `$lookup` 后的嵌套数组），直接使用 `andexpression` 或 `map` 操作可能导致测试环境返回空数组——根本原因在于测试数据未触发实际的集合关联计算。
在您提供的代码中，items 字段源自 $activeItems，tables 字段通过 $map 作用于 $activeTables，但关键前提是：$activeItems 和 $activeTables 必须是真实存在的字段或已由上游阶段（如 $lookup）正确注入。而问题根源恰恰在于：这些字段并非文档原始字段，而是需通过集合关联动态生成的派生字段。
您在答案中指出的修复方式——使用 Aggregation.lookup() 显式关联集合——正是解决该问题的核心：
// ✅ 正确：先通过 lookup 动态填充 activeItems（假设其来自另一集合）
final var lookupItemsStage = Aggregation.lookup(
mongoProperties.getItemsCollectionName(), // 关联的目标集合名
"somethingId", // 当前文档中用于匹配的字段（如 something.id）
"somethingId", // 目标集合中的匹配字段
"activeItems" // 输出字段名 → 后续 projection 才能引用 "$activeItems"
);
// ✅ 同理处理 activeTables
final var lookupTablesStage = Aggregation.lookup(
mongoProperties.getTablesCollectionName(),
"somethingId",
"somethingId",
"activeTables"
);
// ✅ 再执行 projection，此时 $activeItems 和 $activeTables 已真实存在
final var projectStage = Aggregation.project()
.andInclude("name")
.andExpression("$activeItems").as("items")
.and(VariableOperators.Map.itemsOf("$activeTables")
.as("table")
.andApply(doc -> new Document()
.append("tableName", "$$table.tableName")
.append("tableId", "$$table.tableId")
)
).as("tables");⚠️ 重要注意事项：
-
测试环境数据一致性：集成测试使用的测试数据库必须包含
activeItems和activeTables所依赖的关联集合数据，且lookup的localField/foreignField匹配逻辑在测试数据中必须成立（例如somethingId值需真实对应）。 -
字段命名严格区分：
$activeItems中的activeItems是$lookup阶段as("activeItems")定义的输出字段名，不能拼写错误或大小写不一致。 -
DTO 结构需完全匹配投影结构：
SomethingDto.tables的类型必须为List<tabledto></tabledto>，且TableDto字段名（tableId/tableName）需与$map中document.append(...)的键名完全一致（包括大小写），否则反序列化时字段将被忽略，表现为null或空列表。 -
避免混合使用
Document和类型安全 API：虽然andApply接收Function<document document></document>是合法的，但更推荐使用AggregationFields或Fields.from(...)提升可维护性；若必须用Document，请确保其键名与 MongoDB 返回的字段名 100% 一致。
✅ 总结：Spring Data MongoDB 的聚合投影本身无 Bug，但其行为高度依赖上游阶段是否真实生成了目标字段。$activeItems 不是静态字段，而是 $lookup 的“产物”；缺失该阶段，$activeItems 在测试环境中即为 undefined，导致后续 $map 和 andExpression 作用于 null，最终 items/tables 为空。因此，完整聚合流程应为：lookup → project（含 map/expression）→ ...，并在测试中严格保障关联数据就位。
