Spring Data Mongo如何仅查询嵌套列表中指定匹配元素？

完全可以在不使用@DBRef的情况下，仅获取嵌套在Customer中的指定CreditCard元素，以下是几种可行方案：

方案一：使用MongoTemplate聚合框架（支持返回所有匹配的嵌套元素） #

聚合框架能灵活处理数组拆分、过滤与重组，适合需要返回所有符合条件的CreditCard场景：

首先假设CreditCard类结构如下：

public class CreditCard {
    private String cardNumber;
    // 其他字段（如有效期、卡类型等）
    // getter、setter方法
}

然后通过MongoTemplate编写聚合逻辑：

@Autowired
private MongoTemplate mongoTemplate;

public Customer getCustomerWithTargetCreditCard(String targetCardNumber) {
    // 构建聚合管道
    Aggregation aggregation = Aggregation.newAggregation(
        // 第一步：筛选出包含目标卡号信用卡的用户
        Aggregation.match(Criteria.where("creditCards.cardNumber").is(targetCardNumber)),
        // 第二步：拆分creditCards数组，将每个元素转为独立文档
        Aggregation.unwind("creditCards"),
        // 第三步：过滤出仅包含目标卡号的信用卡文档
        Aggregation.match(Criteria.where("creditCards.cardNumber").is(targetCardNumber)),
        // 第四步：重新组合用户信息，将匹配的信用卡放回数组
        Aggregation.group("_id")
            .first("name").as("name")
            .first("surname").as("surname")
            .push("creditCards").as("creditCards"),
        // 第五步：映射字段，确保_id对应Customer的id属性
        Aggregation.project("name", "surname", "creditCards")
            .and("_id").as("id")
    );

    // 执行聚合查询并返回结果
    AggregationResults<Customer> results = mongoTemplate.aggregate(aggregation, "customer", Customer.class);
    return results.getUniqueMappedResult();
}

方案二：在MongoRepository中使用@Query注解（仅返回第一个匹配元素） #

如果业务上卡号唯一，仅需返回第一个匹配的CreditCard，可以直接在Repository接口中自定义查询：

public interface CustomerRepository extends MongoRepository<Customer, String> {

    /**
     * 根据卡号查询用户，仅返回匹配的信用卡元素
     * @param cardNumber 目标卡号
     * @return 包含匹配信用卡的用户对象
     */
    @Query(value = "{ 'creditCards.cardNumber' : ?0 }", 
           fields = "{ 'creditCards' : { '$elemMatch' : { 'cardNumber' : ?0 } }, 'name' : 1, 'surname' : 1 }")
    Optional<Customer> findByCreditCardNumber(String cardNumber);
}

注意事项： #

• $elemMatch会返回数组中第一个符合条件的元素，若存在多个同卡号的信用卡（业务上应避免），仅会返回第一个；
• 以上方案均无需将CreditCard拆分为独立文档，完全保留嵌套结构，既满足Mongo Compass的可视化需求，也能保证查询性能。

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