如何在MongoDB + Java(JPA)场景下正确实现UUID生成配置

你之前使用的@GeneratedValue、@GenericGenerator属于JPA/Hibernate生态的主键生成注解，仅适配关系型数据库ORM场景，Spring Data MongoDB有独立的注解体系和主键生成逻辑，无法识别这两个注解属于正常情况。

方案1：框架内置自动生成（代码最简洁） #

Spring Data MongoDB原生支持UUID类型主键，只要使用MongoDB专属的@Id注解标记UUID类型字段，插入数据时框架会自动补全主键值：

// 注意导包不要引入JPA相关注解
import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;
import java.util.UUID;

@Document(collection = "file_info") // 替换为实际业务使用的集合名
public class FileEntity {
    @Id
    private UUID fileId;

    // 其余业务字段、构造方法、getter/setter省略
}

注意：部分低版本Spring Data MongoDB默认会为空@Id字段生成ObjectId类型值，如果出现主键类型不匹配报错，直接使用方案2即可，没有版本兼容问题。

方案2：显式指定UUID生成规则（兼容性最好） #

如果需要明确控制UUID版本（比如通用的v4随机UUID），可以直接在字段初始化时生成UUID，不需要依赖额外框架注解，逻辑完全可控：

import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;
import java.util.UUID;

@Document(collection = "file_info")
public class FileEntity {
    @Id
    // 实例化实体时直接生成v4随机UUID，插入MongoDB时不会被框架覆盖
    private UUID fileId = UUID.randomUUID();

    // 其余业务字段省略
}

如果需要统一给多个实体类生成UUID主键，避免每个实体都写初始化逻辑，可以注册MongoDB生命周期监听器，在数据转换插入前统一赋值：

import org.springframework.data.mongodb.core.mapping.event.AbstractMongoEventListener;
import org.springframework.data.mongodb.core.mapping.event.BeforeConvertEvent;
import org.springframework.stereotype.Component;
import java.util.UUID;

@Component
public class MongoUuidIdListener extends AbstractMongoEventListener<Object> {
    @Override
    public void onBeforeConvert(BeforeConvertEvent<Object> event) {
        Object entity = event.getSource();
        // 示例：判断为FileEntity类型且主键为空时生成UUID，可根据自身业务扩展匹配规则
        if (entity instanceof FileEntity fileEntity && fileEntity.getFileId() == null) {
            fileEntity.setFileId(UUID.randomUUID());
        }
    }
}

• 操作MongoDB的实体类不要混用JPA包下的@Column、@Table等关系型数据库注解，所有MongoDB专属注解均来自org.springframework.data.mongodb包
• 主键字段的@Id注解要导入org.springframework.data.annotation.Id，不要导入javax.persistence.Id

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