Java实体调用数据库函数：@Formula取值为null的实现方案探寻

你当前写法出现查询结果为null的核心原因有三个：

• 存在字段自引用循环：被@Formula标记的name字段本身是派生计算列，而非数据库表中存在的物理列，但你在@Formula的逻辑中又把name作为函数入参引用，Hibernate生成查询SQL时会找不到对应列，自然返回null
• 写映射冲突：如果name本身是数据库表中存在的物理持久化列，给它加上@Formula注解的操作，会直接让Hibernate忽略该字段的所有写操作映射，后续查询时也不会把该列的原始值查出来，而是直接拼函数SQL取数
• 语法适配问题：@Formula中使用MySQL反引号包字段名，会导致生成的SQL出现转义冲突，触发隐式查询异常

@Formula的本质是Hibernate生成Select查询语句时，将注解值作为原生SQL片段拼接到查询列列表中，属于只读派生字段，完全不参与Insert/Update的写流程，使用时必须遵守以下规则：

• 注解中的值必须写数据库表的物理列名，不能引用Java实体属性、其他派生字段
• 不需要手动使用反引号、引号做关键字转义，Hibernate会自动适配数据库的转义规则
• 必须把真实需要持久化的源字段单独定义为实体属性，不能和派生计算字段共用同一个属性

正确写法示例：

// 数据库表中真实存在的物理列，正常参与持久化
@Column(name = "raw_name")
private String rawName;

// 派生计算字段，只做查询映射，不参与写操作
@Formula(value = "someschema.somefunction(raw_name)")
@JsonProperty("name")
private String name;

@PrePersist是实体写入数据库前执行的回调，本身不会触发数据库交互，无法直接在方法内调用数据库侧函数，可行实现方式为：

• 通过静态工具类获取已注入的数据库操作实例（JdbcTemplate/Hibernate Session），在回调中显式执行原生SQL调用函数，将返回值赋值给对应实体字段
• 代码参考：

// 实体类的PrePersist方法
@PrePersist
protected void onCreate(){
    this.id = String.valueOf(UUID.randomUUID());
    // 调用封装好的工具类执行数据库函数，拿到计算结果
    this.name = SpringContextUtil.getJdbcTemplate().queryForObject(
        "SELECT someschema.somefunction(?)",
        String.class,
        this.rawName
    );
}

注意：不要直接在实体类中注入Spring Bean，实体类不受Spring容器管理，需要通过ApplicationContextAware实现的静态工具类获取Bean实例

• 数据库生成列方案：如果使用MySQL 8.0+版本，可直接在表结构定义时将目标字段设置为函数生成的虚拟列/存储列，实体类中仅需通过@Generated注解标记该字段由数据库生成即可，无需手动写计算逻辑
• Hibernate事件监听方案：实现PreInsertEventListener/PreUpdateEventListener接口，在实体持久化事件触发时统一拦截，调用自定义函数完成字段赋值，适合多实体复用同套派生字段逻辑的场景
• 数据库触发器方案：在表层面配置Insert/Update触发器，当源字段值变更时自动调用自定义函数更新目标字段值，实体类将对应字段标记为只读即可
• 自定义Hibernate生成器：实现IdentifierGenerator接口，在字段值生成阶段调用数据库函数，适合需要持久化存储函数计算结果的场景

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