Spring Boot MongoDB应用出现Ambiguous field mapping映射异常求助

问题根源 #

你遇到的这个映射冲突，核心原因是误用了Spring Data框架内部的org.springframework.data.mapping.Association类作为业务实体的字段类型。

这个Association类是Spring Data用来描述实体属性间关联关系的元数据工具类，它继承自PersistentProperty，而后者又依赖了Spring Data内部的TypeDiscoverer和ClassTypeInformation类——这两个类都有一个名为type的字段。当MongoDB的映射框架扫描你的ConfigEntity时，会递归扫描Association类的所有继承属性，最终发现两个type字段都要映射到MongoDB文档的type字段，从而抛出冲突异常。

因为这些type字段是Spring Data内部类的属性，你无法直接修改或通过@Field注解来重命名，所以必须从根源上解决这个问题。

解决方案：自定义业务用的Association类 #

你需要创建一个属于自己的业务级Association类，完全替代Spring Data内部的那个类，具体步骤如下：

1. 创建自定义的MyAssociation类
   这个类是普通的POJO，只包含你业务需要的属性，示例如下：

   import lombok.Data;
   import lombok.NoArgsConstructor;
   import java.io.Serializable;
   
   @Data
   @NoArgsConstructor
   public class MyAssociation implements Serializable {
       private static final long serialVersionUID = 1L;
       
       // 根据你的业务需求添加字段，比如：
       private String targetId;
       private String associationType;
       // 其他你需要的业务字段...
   }
   

2. 修改ConfigEntity中的字段类型
   替换原来的Spring Data Association导入，换成你自己的类：

   import java.io.Serializable;
   import java.util.List;
   import javax.validation.constraints.NotNull;
   import org.springframework.data.annotation.Id;
   import org.springframework.data.mongodb.core.mapping.Document;
   import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
   import com.fasterxml.jackson.annotation.JsonProperty;
   import lombok.Data;
   import lombok.NoArgsConstructor;
   // 替换Spring Data的Association为自定义类
   import com.xyz.abc.core.model.MyAssociation;
   
   @Data
   @NoArgsConstructor
   @Document(collection="configstore")
   @JsonIgnoreProperties(ignoreUnknown = true)
   public class ConfigEntity implements Serializable {
       private static final long serialVersionUID = -5484736588242242417L;
   
       @Id
       private String id;
   
       @NotNull
       @JsonProperty("defaultAssociations")
       private List<MyAssociation> defaultAssociations;
   
       @NotNull
       @JsonProperty("profileAssociations")
       private List<MyAssociation> profileAssociations;
   }
   

3. 验证依赖与配置
   你的ConfigRepository代码不需要修改，因为它只依赖ConfigEntity，修改实体类后就能正常工作。

额外注意事项 #

• 如果你的MongoDB集合中已经存储了旧数据，需要确保旧数据的结构和新的MyAssociation类兼容，或者做适当的数据迁移。
• 如果需要自定义MongoDB字段名，可以在自定义类的字段上添加@Field("custom_field_name")注解来映射。

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