Spring MongoTemplate查询文档数组返回空，同条件Robo 3T有结果的问题

先梳理下你的问题场景：

• 你有MongoDB的bios示例结构数据，存在本地testentity集合中
• 用Robo 3T执行db.bios.find( { awards: { $elemMatch: { award: "Turing Award", year: { $gt: 1980 } } } } )能查到3条结果
• 用Spring MongoTemplate写了对应查询，生成的查询语句和Robo3T里的一致，但Java代码返回的结果集合为空

结合开发经验，大概率是实体类映射、集合/数据库匹配这几个环节出了问题，下面分点排查：

1. 实体类字段映射错误（最常见原因） #

你的TestEntity类和MongoDB文档的字段结构、类型必须完全对应，否则即使MongoDB返回了数据，Spring也无法把文档映射成实体对象，最终返回空列表。

举个正确的实体类示例，你可以对照检查：

import org.springframework.data.mongodb.core.mapping.Document;
import java.util.Date;
import java.util.List;

@Document(collection = "testentity") // 确保集合名称和代码里的一致
public class TestEntity {
    private String _id;
    private Name name;
    private Date birth;
    private Date death;
    private List<String> contribs;
    private List<Award> awards;

    // 必须要有无参构造器，Spring映射需要
    public TestEntity() {}

    // Getters & Setters

    public static class Name {
        private String first;
        private String last;

        public Name() {}
        // Getters & Setters
    }

    public static class Award {
        private String award;
        private Integer year; // 注意这里的类型要和MongoDB里的year类型一致
        private String by;

        public Award() {}
        // Getters & Setters
    }
}

需要重点检查：

• 嵌套类（比如Name、Award）是否有无参构造器？Spring反射实例化对象需要这个
• 字段名称是否完全匹配？比如MongoDB里是award，实体类里不能写成awardName，除非用@Field("award")指定映射
• 数据类型是否一致？比如MongoDB里的year是NumberInt类型，实体类里要用Integer；如果是NumberLong，就要用Long，类型不匹配会导致映射失败

2. 集合/数据库名称不匹配 #

MongoDB的集合名称是区分大小写的，数据库名称也是如此：

• 检查你的mongoTemplate.find方法第三个参数是"testentity"，那Robo3T里查询的是不是同一个集合？比如有没有可能实际集合是TestEntity或者testEntity？
• 确认MongoTemplate连接的数据库和Robo3T里的一致，可以在代码里加一行打印验证：

  System.out.println("当前连接的数据库：" + mongoTemplate.getDb().getName());
  

3. 启用MongoDB日志排查细节 #

如果上面的检查都没问题，可以开启Spring的MongoDB调试日志，看实际发送的请求和MongoDB返回的原始数据：
在application.properties（或application.yml）里添加：

logging.level.org.springframework.data.mongodb.core=DEBUG

日志里会显示：

• 实际发送给MongoDB的查询语句
• MongoDB返回的文档数量
• 映射实体对象时的异常（如果有的话）
  这样就能明确是MongoDB没返回数据，还是映射环节出了问题。

4. 数据类型的小坑 #

你代码里用了new Integer(1980)，虽然MongoDB的$gt对数字类型兼容，但如果实体类里的year字段是Long，而MongoDB里是Integer，或者反过来，也可能导致映射后的数据不符合预期？不过这个概率较低，但可以顺便检查下。

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