Spring Boot连接MongoDB读取文档返回空的正确配置与排查方案

现有配置校验 #

你当前配置的spring.data.mongodb相关参数完全满足单机无认证MongoDB的连接要求，无需额外补充基础连接项。
Spring Boot对MongoDB的配置加载逻辑如下：

• 加载时机：应用启动的环境准备阶段，application.properties/application.yml中前缀为spring.data.mongodb的配置项会被统一加载到Spring上下文的Environment实例中
• 绑定时机：容器初始化MongoClient核心Bean时，MongoProperties配置类会自动从上下文中读取host、port、database等参数，构造可用的MongoDB连接实例，无需手动注册连接Bean
• 配置中spring.servlet.multipart开头的参数是文件上传相关配置，和MongoDB连接、读写逻辑完全无关，不影响接口返回结果。

接口返回[{}]的核心原因 #

返回长度为1、内容为空对象的数组，说明findAll()方法实际已经从MongoDB中查询到1条文档，但是文档内容无法正确映射到Skiing实体类，序列化后所有字段为null，最终输出空对象。90%以上的同类问题由以下原因导致：

• Skiing实体类未遵循JavaBean规范，缺失属性对应的getter/setter方法，导致Spring Data无法填充字段值、Jackson序列化时读不到属性
• 实体类未通过@Document注解指定正确的集合名，默认映射规则（类名首字母小写作为集合名）和MongoDB中实际集合名不匹配，查询到了其他集合的脏数据
• 实体类字段名和MongoDB集合中实际存储的字段名不一致，未通过@Field注解做映射绑定
• 主键字段未加@Id注解，无法映射MongoDB自带的_id字段

正确的实体类写法参考 #

import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;
import org.springframework.data.mongodb.core.mapping.Field;

// 指定实体类映射的MongoDB集合名称，不写则默认取类名首字母小写作为集合名
@Document(collection = "skiing")
public class Skiing {
    // 标记主键字段，映射MongoDB的_id字段
    @Id
    private String id;
    // 若MongoDB中字段名和Java属性名不一致，用@Field指定实际存储的字段名
    @Field("resort_name")
    private String resortName;
    private Integer difficultyLevel;
    private String location;
    private Double ticketPrice;

    // 必须为所有属性添加标准getter/setter，不要使用破坏JavaBean规范的链式调用注解
    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }

    public String getResortName() {
        return resortName;
    }

    public void setResortName(String resortName) {
        this.resortName = resortName;
    }

    public Integer getDifficultyLevel() {
        return difficultyLevel;
    }

    public void setDifficultyLevel(Integer difficultyLevel) {
        this.difficultyLevel = difficultyLevel;
    }

    public String getLocation() {
        return location;
    }

    public void setLocation(String location) {
        this.location = location;
    }

    public Double getTicketPrice() {
        return ticketPrice;
    }

    public void setTicketPrice(Double ticketPrice) {
        this.ticketPrice = ticketPrice;
    }
}

数据一致性校验 #

直接通过Mongo Shell连接实例，核对库、集合、字段是否和配置、实体类匹配：

# 切换到配置文件指定的数据库
use tripadvisor
# 查看库下所有集合，确认目标集合存在
show collections
# 查询目标集合的文档，核对字段名、数据内容
db.skiing.find()

如果集合名、字段名和代码中配置不一致，修改对应注解的值即可。

Spring Boot对接MongoDB标准实现流程 #

• 引入核心依赖，Maven项目在pom.xml中添加官方starter：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-mongodb</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

• 配置连接参数，单机无认证场景直接使用你现有的配置即可，带账号密码的场景补充用户名密码配置：

spring.data.mongodb.host=localhost
spring.data.mongodb.port=27017
spring.data.mongodb.database=tripadvisor
# 带认证时追加以下配置
# spring.data.mongodb.username=your_username
# spring.data.mongodb.password=your_password
# spring.data.mongodb.authentication-database=admin

• 编写集合映射实体类，参考上文的Skiing类规范编写。
• 编写Repository层接口，你当前的Repository代码写法正确，MongoRepository内置的findAll()方法已经支持全表查询，无需额外实现：

@Repository
public interface SkiingRepository extends MongoRepository<Skiing, String> {
}

• 编写Service、Controller层逻辑，你当前的Service、Controller代码逻辑没有问题，实体类映射正确后即可正常返回结构化数据。

快速调试方法 #

如果无法定位映射问题，可以直接注入MongoTemplate打印原始查询结果，确认数据本身是否正常：

@Autowired
private MongoTemplate mongoTemplate;

@Override
public List<Skiing> getAllSkiing() {
    // 直接查询原始BSON文档
    List<org.bson.Document> rawDocs = mongoTemplate.findAll(org.bson.Document.class, "skiing");
    System.out.println("查询到的文档总数：" + rawDocs.size());
    rawDocs.forEach(doc -> System.out.println("原始文档内容：" + doc.toJson()));
    return skiingRepository.findAll();
}

如果控制台打印的原始文档包含正常业务字段，即可确定问题出在Skiing实体类的映射规则或getter/setter缺失上。

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