Spring Boot+MongoDB：文档部分字段无法映射至POJO的问题

核心原因 #

你用错了映射注解：@BsonProperty是MongoDB原生Java Driver的注解，而Spring Data MongoDB默认使用自身的@Field注解处理实体属性与文档字段的映射，Spring Data不会识别@BsonProperty的配置，因此带空格的字段无法映射到实体属性。

解决步骤 #

• 替换映射注解：将实体类中对应带空格字段的@BsonProperty替换为org.springframework.data.mongodb.core.mapping.Field注解，明确指定文档中的字段名。示例代码：

  import org.springframework.data.mongodb.core.mapping.Field;
  
  public class Card {
      private String name;
      private String edition;
  
      @Field("unit size")
      private Integer unitSize;
  
      @Field("warjack points")
      private Integer warjackPoints;
  
      @Field("field allowance")
      private String fieldAllowance;
  
      // getter、setter方法省略
  }
  

• 校验字段匹配性：确保@Field指定的字段名与MongoDB文档中的字段完全一致（包括空格、大小写），同时实体属性类型要和文档字段类型匹配（比如文档存数字类型，实体属性不能用String）。
• 确认依赖有效性：检查项目依赖配置（Maven的pom.xml或Gradle的build.gradle），确保Spring Data MongoDB依赖正确引入且版本与Spring Boot兼容。比如Maven依赖：

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

• 调试验证原始文档：查询后打印原始Document对象，确认文档中确实存在目标字段，排除字段名拼写错误导致的映射失败。示例代码：

  MongoTemplate mongoTemplate = ...;
  Document doc = mongoTemplate.findById("目标文档ID", Document.class, "card-collection");
  System.out.println(doc); // 查看原始文档的完整内容
  

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