Quarkus迁移Hibernate 6后数值类型null转0问题求助

核心原因 #

Hibernate 6 对基本包装类型的默认映射逻辑有调整，加上 GraalVM 原生镜像构建时的字段初始化优化，导致部署后数据库的 null 值被自动转为数值类型的默认值（0），而本地 dev 模式下没有触发这种优化，所以表现正常。

可行解决方案 #

1. 显式配置字段的 null 可选项 #

通过 @Basic(optional = true) 配合 @Column(nullable = true) 强制 Hibernate 保留 null 值，同时确保数据库列本身允许 null：

import jakarta.persistence.Basic;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import io.quarkus.hibernate.orm.panache.PanacheEntity;

@Entity
public class Product extends PanacheEntity {
    @Basic(optional = true)
    @Column(nullable = true)
    private Integer stockCount;

    @Basic(optional = true)
    @Column(nullable = true)
    private Float discountRate;
    // getter/setter 或 Panache 自动生成的方法
}

注意：不要给字段设置默认值（比如 private Integer stockCount = 0;），保持字段未初始化状态。

2. 配置 GraalVM 反射元数据 #

GraalVM 构建原生镜像时可能会提前初始化字段为默认值，需要将实体类及其字段加入反射配置：

方法一：使用注解标记

直接在实体类上添加 @RegisterForReflection，让 Quarkus 自动处理反射元数据：

import io.quarkus.runtime.annotations.RegisterForReflection;
import jakarta.persistence.Entity;
import io.quarkus.hibernate.orm.panache.PanacheEntity;

@Entity
@RegisterForReflection
public class Product extends PanacheEntity {
    // 字段定义
}

方法二：手动配置反射文件

在 application.properties 中添加：

quarkus.native.additional-build-args=-H:ReflectionConfigurationFiles=reflection-config.json

然后在项目根目录创建 reflection-config.json，指定需要反射的实体类和字段：

[
  {
    "name": "com.yourcompany.model.Product",
    "fields": [
      {"name": "stockCount"},
      {"name": "discountRate"}
    ]
  }
]

3. 启用 JPA 空值合规性配置 #

在 application.properties 中添加以下配置，强制 Hibernate 严格遵循 JPA 规范处理 null 值：

hibernate.jpa.compliance.nullability=true

这个配置会禁用 Hibernate 自动将 null 转为默认值的行为。

4. 避免使用基本类型（如 int/float） #

确保实体类中使用的是包装类型（Integer/Float/Long）而非基本类型，基本类型本身无法存储 null，Hibernate 会自动将其转为默认值 0。

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