Hibernate实体字段校验失效求助：空字符串仍被允许

问题核心 #

你遇到的问题是：为String类型主键添加@NotBlank/@NotEmpty等Jakarta Validation注解后，系统仍允许空字符串存入；仅@NotNull对null值生效，空字符串无法被拦截。这是因为Hibernate默认不会自动触发Jakarta Validation的校验逻辑，且这类注解不会直接生成数据库层面的非空白约束。

解决方案 #

1. 手动调用校验器（最直接有效） #

在实体持久化/合并前，手动触发Jakarta Validation的校验逻辑，拦截不符合约束的输入。

修改你的merge方法，添加校验步骤：

import jakarta.validation.Validation;
import jakarta.validation.Validator;
import jakarta.validation.ValidatorFactory;
import jakarta.validation.ConstraintViolation;
import java.util.Set;

public void merge(T entity) {
    // 初始化校验器并执行校验
    try (ValidatorFactory factory = Validation.buildDefaultValidatorFactory()) {
        Validator validator = factory.getValidator();
        Set<ConstraintViolation<T>> violations = validator.validate(entity);
        if (!violations.isEmpty()) {
            throw new jakarta.validation.ConstraintViolationException(violations);
        }
    }
    // 执行Hibernate持久化操作
    HibernateUtility.getSessionFactory().inTransaction(session -> {
        session.merge(entity);
        session.flush();
    });
}

当Apartment.id为空字符串时，@NotBlank会触发校验失败，抛出ConstraintViolationException，阻止数据存入。

2. 配置Hibernate自动触发校验 #

通过配置让Hibernate在执行persist/merge等操作时自动校验实体约束：

• 在Hibernate配置文件（如hibernate.cfg.xml）中添加：

<property name="hibernate.validator.autoregister_listeners">true</property>

注意：需确保项目已引入正确的Jakarta Validation和Hibernate Validator依赖，否则该配置无效。

3. 补充数据库层面约束（双重保障） #

@NotBlank等注解不会自动生成数据库的CHECK约束，空字符串不属于null，因此数据库会允许存入。可以通过@Column注解手动添加数据库约束：

修改Apartment类的主键字段：

@Id
@NotBlank
@Column(nullable = false, columnDefinition = "VARCHAR(255) CHECK (TRIM(id) <> '')")
private String id;

设置hibernate.hbmddl.auto=create-drop重建表后，数据库会直接拒绝空字符串或纯空格的id值。

额外注意事项 #

• 依赖正确性：确保项目引入了Jakarta Validation API和Hibernate Validator实现，Maven依赖示例：

<dependency>
    <groupId>jakarta.validation</groupId>
    <artifactId>jakarta.validation-api</artifactId>
    <version>3.0.2</version>
</dependency>
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>8.0.1.Final</version>
</dependency>

• 代码规范：避免在Controller中直接实例化Service和Repository，可使用依赖注入框架（如Guice、Spring）管理组件，便于统一处理校验等逻辑。

内容的提问来源于stack exchange，提问作者Giao Le Xuan