使用Long时验证正常，切换为UUID后实体验证失效问题

一、Bean Validation失效问题 #

原因分析 #

当ID从Long（采用GenerationType.IDENTITY自增策略）切换到UUID后，原有的约束触发逻辑被打破：

• 使用Long自增ID时，插入操作会触发数据库层面的NOT NULL约束校验，直接抛出异常；
• 切换到UUID后，若ID由客户端生成或通过JPA非IDENTITY策略生成，Hibernate默认不会主动触发Bean Validation（@NotNull/@NotBlank）；同时H2内存库对约束校验存在宽松行为（即便表结构定义了NOT NULL，仍允许插入null值），而SQL Server虽拒绝插入不符合约束的数据，但不会主动抛出JPA层面的ConstraintViolationException。

解决方法 #

1. 确认依赖完整性

确保项目引入了Bean Validation核心依赖（Spring Boot项目直接使用spring-boot-starter-validation）：

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

2. 手动触发校验（推荐）

在Service层调用repository.save()前，通过Validator手动校验实体：

@Service
public class EntityService {
    private final Validator validator;
    private final EntityRepository repository;

    public EntityService(Validator validator, EntityRepository repository) {
        this.validator = validator;
        this.repository = repository;
    }

    public <T> T save(T entity) {
        Set<ConstraintViolation<T>> violations = validator.validate(entity);
        if (!violations.isEmpty()) {
            throw new ConstraintViolationException(violations);
        }
        return repository.save(entity);
    }
}

3. 配置Hibernate自动校验

在application.properties/application.yml中添加配置，让Hibernate在CRUD操作时自动触发Bean Validation：

spring.jpa.properties.javax.persistence.validation.mode=ALL

二、UUID生成策略问题 #

错误原因 #

GenerationType.IDENTITY依赖数据库自增列逻辑，但UUID类型字段无法通过数据库自增生成（SQL Server的NEWID()是字段默认值而非自增逻辑），因此会抛出unrecognized id type : uuid -> java.util.UUID错误。

正确生成策略 #

1. 客户端主动生成

在实体构造方法中初始化UUID：

@Entity
public class YourEntity {
    @Id
    private UUID id;
    @NotNull
    private String name;

    public YourEntity() {
        this.id = UUID.randomUUID();
    }

    // getters & setters
}

2. 用Hibernate内置UUID生成器

使用Hibernate的@UuidGenerator注解（需Hibernate 5.3及以上版本）：

@Id
@UuidGenerator
private UUID id;

3. 旧版Hibernate兼容方案

通过@GenericGenerator指定uuid2生成策略：

@Id
@GeneratedValue(generator = "uuid2")
@GenericGenerator(name = "uuid2", strategy = "uuid2")
private UUID id;

三、额外验证步骤 #

• 确认实体类的@NotNull/@NotBlank注解应用在正确字段上（注意@NotBlank仅适用于字符串类型）；
• 检查SQL Server日志，确认插入操作是否因约束被数据库拒绝，可通过配置spring.jpa.properties.hibernate.jdbc.lob.non_contextual_creation=true优化SQL Server兼容性，确保JPA能正确捕获并转换数据库异常。

内容的提问来源于stack exchange，提问作者It is what it is