JPA Entity中为BigDecimal列设置默认值，columnDefinition配置不生效如何解决

JPA BigDecimal字段默认值不生效的原因&解决方案 #

你当前配置失效的常见原因如下：

1. columnDefinition写法错误：BigDecimal对应数据库数值类型，默认值不需要加单引号，加单引号会被识别为字符串，无法匹配数值类型规则导致不生效
2. columnDefinition仅在JPA自动生成/更新表结构时生效，如果你对应的数据表已经提前创建完成，注解配置不会同步修改已有表的字段默认值，需要手动修改表结构
3. 若插入数据时显式给对应字段赋值为null，数据库的默认值规则不会触发，只会写入null值

方案1：修正columnDefinition配置（依赖JPA自动建表）

调整@Column注解配置，匹配你需要的数值精度即可：

// DECIMAL的总长度、小数位可根据业务调整，默认值不加单引号，配合nullable = false避免null值写入
@Column(name = "QUANTITE_CHARGE", columnDefinition = "DECIMAL(19,9) DEFAULT 0", nullable = false)
private BigDecimal quantiteCharge;

如果表已经提前创建，手动执行SQL修改字段即可，以MySQL为例：

ALTER TABLE detail_tournee MODIFY COLUMN QUANTITE_CHARGE DECIMAL(19,9) DEFAULT 0 NOT NULL;

方案2：实体字段直接初始化（最通用，不依赖建表逻辑）

直接在定义字段时给初始值，实体对象实例化时就会带上默认值，不需要依赖数据库的默认值规则：

// 初始化为0，保留9位小数，和你需要的精度匹配，其余字段同理配置即可
private BigDecimal quantiteCharge = BigDecimal.ZERO.setScale(9);
private BigDecimal quantiteChargesSupp = BigDecimal.ZERO.setScale(9);
private BigDecimal quantiteDechet = BigDecimal.ZERO.setScale(9);
private BigDecimal quantiteRetour = BigDecimal.ZERO.setScale(9);
private BigDecimal quantiteUnite = BigDecimal.ZERO.setScale(9);
private BigDecimal quantiteVendue = BigDecimal.ZERO.setScale(9);

方案3：使用Hibernate专属@ColumnDefault注解（仅Hibernate ORM框架适用）

如果你用的是Hibernate作为JPA实现，可以用更简洁的@ColumnDefault注解配置默认值，同样仅在自动建表时生效：

@Column(name = "QUANTITE_CHARGE", nullable = false)
@ColumnDefault("0")
private BigDecimal quantiteCharge;

注意：如果你的业务代码中存在主动给这些BigDecimal字段赋值为null的逻辑，上述配置都会失效，需要调整业务逻辑避免传null，或者在字段的set方法中增加判空逻辑，传入null时自动赋值为默认的0值。

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