Hibernate无法正确更新PostgreSQL表问题求助

问题场景 #

尝试多个版本组合（Spring Boot 3.3.0/3.2.2/3.1.8、PostgreSQL 16/15/14/12、Java 17/21）均未解决：

1. 首次启动应用后，Hibernate生成的表结构符合预期：

   CREATE TABLE public.users (
       id varchar(255) NOT NULL,
       "password" varchar(255) NULL,
       user_name varchar(255) NULL,
       CONSTRAINT users_pkey PRIMARY KEY (id)
   );
   

2. 给实体类userName字段添加@Column(unique = true)后重启，表结构无变化，Hibernate也无相关日志，唯一约束未添加。
3. 将实体类字段名改为userNameTest后重启，Hibernate新增user_name_test列并为其添加唯一约束，而非修改原有user_name列：

   Hibernate: alter table if exists users add column user_name_test varchar(255)
   Hibernate: alter table if exists users drop constraint if exists UK_kh8r0uhi4t5fb09nkdjjnopeg
   Hibernate: alter table if exists users add constraint UK_kh8r0uhi4t5fb09nkdjjnopeg unique (user_name_test)
   

   最终表结构出现冗余列，未达到修改原有列并添加约束的预期。

配置与代码 #

application.properties #

spring.datasource.url=jdbc:postgresql://localhost:5432/randoset
spring.datasource.username=postgres
spring.datasource.password=postgres
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
logging.level.org.hibernate.SQL=DEBUG

实体类与Repository #

package se.randoset.entity

import jakarta.persistence.Column
import jakarta.persistence.Entity
import jakarta.persistence.Id
import jakarta.persistence.Table
import org.springframework.data.jpa.repository.JpaRepository
import org.springframework.stereotype.Repository
import java.util.UUID

@Entity
@Table(name = "users")
class User(
    @Id
    var id: String = UUID.randomUUID().toString(),
    @Column()
    var userName: String,
    var password: String
)

@Repository
interface UserRepository: JpaRepository<User, String>

解决办法 #

1. 显式指定数据库列名，消除命名映射歧义 #

Hibernate的自动命名策略（驼峰转下划线）在字段变更时，可能无法识别实体字段与现有数据库列的关联。修改实体类字段，显式指定对应列名：

@Column(name = "user_name", unique = true)
var userName: String,

这样Hibernate明确知道该字段对应数据库中的user_name列，重启后会尝试为该列添加唯一约束。

2. 统一Hibernate命名策略配置 #

显式配置物理命名策略，避免不同版本的默认行为差异：

spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy

该策略会稳定地将驼峰命名的实体字段转换为下划线分隔的数据库列名，确保映射关系一致。

3. 手动修正表结构（开发环境临时方案） #

如果ddl-auto=update仍不生效，可直接执行SQL手动添加约束：

ALTER TABLE users ADD CONSTRAINT uk_users_user_name UNIQUE (user_name);

若存在冗余列（如user_name_test），可手动删除：

ALTER TABLE users DROP COLUMN user_name_test;

4. 放弃ddl-auto=update，使用数据库迁移工具 #

ddl-auto=update仅适合开发初期快速验证，无法处理复杂结构变更，生产环境必须使用专业迁移工具：

• Flyway：基于SQL脚本的版本化迁移，配置简单，适合SQL优先的场景。
• Liquibase：支持XML/YAML/SQL多种格式，更灵活的结构变更管理。

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