Spring Boot MongoDB配置双字段复合唯一索引失败，求排查

核心问题分析 #

你的代码存在几个关键问题导致复合唯一索引不生效：

1. product_id被标记为@Id
   MongoDB的_id字段本身是全局唯一的，当你把product_id设为@Id后，每个文档的_id（对应你的product_id）只能存在一次，直接导致你想要的「同一product_id+ip唯一」逻辑不成立——同一个product_id根本无法存在多条文档，复合索引的唯一性约束完全被_id的全局唯一性覆盖。

2. 字段映射工具混用
   你使用Jackson的@JsonProperty标注字段，但Spring Data MongoDB推荐用@Field注解明确指定MongoDB集合中的字段名，@JsonProperty仅用于JSON序列化，可能导致索引定义中的字段名和实际存储的字段名不匹配，进而让索引失效。

3. 冗余getter干扰字段映射
   你手动实现的getEmberId()返回product_id，会导致Spring Data MongoDB映射字段时出现混乱，emberId字段的值会被覆盖为product_id的值，虽和索引无直接关联，但会破坏实体数据结构。

修正方案 #

1. 调整主键策略 #

如果业务允许同一product_id下存在多条不同ip的评分记录，不能将product_id设为@Id，建议使用MongoDB自动生成的ObjectId作为独立主键。

2. 修正索引与字段注解 #

使用@Field明确MongoDB字段名，确保复合索引定义和实体字段对应。

修正后的实体类代码 #

@Setter 
@Getter 
@CompoundIndex(def = "{'product_id': 1, 'ip': 1}", unique = true)
@Document(collection = "star_rating")
public class Star_ratingMongo extends AuditMetadata implements Persistable<String> {
    // 使用MongoDB自动生成的ObjectId作为主键
    @Id
    private String id;

    @Field("product_id")
    private Long productId;

    @Field("id_collection")
    private Long emberId;

    @Field("ip")
    private String ip;

    @Field("star")
    private Integer star;

    @Override
    public String getId() {
        return id;
    }

    @Override
    public boolean isNew() {
        return id == null;
    }
}

验证索引是否生效 #

修改代码启动应用后，连接MongoDB执行以下命令查看索引：

db.star_rating.getIndexes()

若能看到包含product_id和ip的复合唯一索引，说明创建成功。

额外注意事项 #

• 若集合中已有不符合约束的数据，需先清理，否则索引创建会失败。
• 确保Spring Data MongoDB版本与MongoDB服务器版本兼容，避免版本差异导致注解不支持。

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