MongoDB嵌套数组查询问题：按clientId和documentId查询返回null

核心问题1：返回类型不匹配 #

你的查询语句实际会返回整个ClientData文档，但方法返回类型是SignedDocument，Spring Data无法自动将完整的ClientData对象转换为SignedDocument，所以返回null。

核心问题2：未指定投影获取嵌套子文档 #

即使返回类型改成ClientData，默认也会返回整个文档，而不是仅匹配的documents子元素。需要通过投影（Projection）来筛选出符合条件的子文档。

正确的实现方式 #

方式1：直接返回匹配的子文档 #

修改@Query添加投影规则，同时调整返回类型以适配结果：

@Query(value = "{ 'clientId': ?0, 'documents.documentId': ?1 }", 
       fields = "{ 'documents.$': 1, '_id': 0 }")
Optional<SignedDocument> findDocument(String clientId, String documentId);

• value部分：简化查询条件，MongoDB会自动处理多个条件的逻辑与，无需显式使用$and
• fields部分：'documents.$': 1表示只返回数组中第一个匹配的子元素，'_id': 0表示不返回默认的_id字段

方式2：先返回完整文档再提取子文档 #

如果需要保留外层文档的其他信息，可先查询完整ClientData，再手动筛选子文档：

@Query("{ 'clientId': ?0, 'documents.documentId': ?1 }")
Optional<ClientData> findClientDataWithDocument(String clientId, String documentId);

// 调用后提取目标子文档
Optional<SignedDocument> signedDoc = findClientDataWithDocument(clientId, docId)
    .map(clientData -> clientData.getDocuments().stream()
        .filter(doc -> doc.getDocumentId().equals(docId))
        .findFirst())
    .orElse(Optional.empty());

额外说明 #

• 单字段匹配嵌套文档时，$elemMatch可以省略，直接用'documents.documentId': ?1更简洁
• 确保SignedDocument类的字段与documents数组中子文档的字段完全对应（如clientId、documentId、title、signed等属性的名称和类型一致）

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