Hibernate 5.6迁移至6.2后PostgreSQL权限错误排查与解决

问题背景 #

近期将Spring Boot应用从2.7版本升级至3.2版本（对应Hibernate升级到6.x），后端使用PostgreSQL数据库，迁移后遇到如下权限错误：

Hibernate: 
    alter table if exists XYZ
       alter column created set data type timestamp(6)
2024-02-28 12:58:05 WARN  o.h.t.s.i.ExceptionHandlerLoggedImpl - GenerationTarget encountered exception accepting command : Error executing DDL "
    alter table if exists XYZ
       alter column created set data type timestamp(6)" via JDBC [ERROR: must be owner of table XYZ]
org.hibernate.tool.schema.spi.CommandAcceptanceException: Error executing DDL "
    alter table if exists cases 
       alter column created set data type timestamp(6)" via JDBC [ERROR: must be owner of table XYZ]

当前环境 #

• Java 17
• Spring Boot 3.2
• Gradle 7.6
• Hibernate 6.2.1-final

疑问与尝试 #

问题：

1. 为何Hibernate 5.6版本时未出现该权限问题？
2. 如何解决当前的权限错误？

已尝试无效方案：

• 为created字段添加@Column(columnDefinition = "TIMESTAMP")注解
• 将字段类型从LocalDateTime改为ZonedDateTime

Hibernate配置 #

jpa:
  hibernate:
    ddl-auto: update
    naming:
      implicit-strategy: org.hibernate.boot.model.naming.ImplicitNamingStrategyJpaCompliantImpl
  properties:
    hibernate:
      format_sql: true
      dialect: org.hibernate.dialect.PostgreSQLDialect
    org:
      hibernate:
        envers:
          audit_table_suffix: _AUD
          revision_field_name: REVISION_ID
          revision_type_field_name: REVISION_TYPE
  show-sql: true

原因分析：为什么Hibernate 5.6没有触发该问题？ #

Hibernate 6.x对PostgreSQL时间类型的映射逻辑做了严格调整：

• 在Hibernate 5.6中，LocalDateTime默认映射为PostgreSQL的TIMESTAMP类型（不带精度），和数据库中已有的列类型一致，因此ddl-auto: update不会触发修改列类型的DDL语句。
• 而Hibernate 6.x默认将LocalDateTime映射为TIMESTAMP(6)（带6位微秒精度），当检测到数据库中列类型是TIMESTAMP时，会尝试执行alter column修改类型，这就需要数据库用户具备表的ALTER或OWNER权限——这正是之前Hibernate 5.6没有触发权限问题的核心原因。

此外，Hibernate 6的Schema校验逻辑比5.x更细致，对类型匹配的要求更高，进一步触发了该DDL操作。

解决方法 #

方案1：调整数据库用户权限 #

直接给操作数据库的用户授予对应表的ALTER权限，或者将用户设为表所有者：

-- 授予ALTER权限
GRANT ALTER ON TABLE XYZ TO your_db_user;

-- 或设置为表所有者
ALTER TABLE XYZ OWNER TO your_db_user;

替换XYZ和your_db_user为实际表名和数据库用户名即可。

方案2：修改Hibernate映射，避免触发DDL修改 #

通过显式配置让Hibernate的类型映射与数据库现有类型一致：

1. 显式指定列定义：

@Column(columnDefinition = "TIMESTAMP(6)")
private LocalDateTime created;

让Hibernate认为数据库列类型和映射类型匹配，不触发修改。

2. 全局配置时间类型映射：
   在application.yml中添加Hibernate类型偏好配置，让LocalDateTime默认映射为TIMESTAMP：

jpa:
  properties:
    hibernate:
      type:
        preferred_local_date_time_jdbc_type: TIMESTAMP

这样Hibernate不会认为列类型需要修改，也就不会执行alter column语句。

方案3：禁用自动DDL（临时应急） #

如果只是临时绕过该问题，可以将ddl-auto设置为none，但后续Schema变更需要手动维护，不推荐长期用于开发环境：

jpa:
  hibernate:
    ddl-auto: none

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