如何阻止JPA修改PostgreSQL数据库列的数据类型？

我在Spring Boot应用中通过Flyway创建了PostgreSQL数据库表及枚举，SQL脚本如下：

CREATE EXTENSION citext;

CREATE TYPE metadata_type AS ENUM ('STRING', 'DATE', 'INTEGER', 'DOUBLE');

CREATE TABLE metadata
(
  id         BIGSERIAL PRIMARY KEY,
  name       CITEXT        NOT NULL,
  type       metadata_type NOT NULL,
  created_at TIMESTAMP     NOT NULL,
  updated_at TIMESTAMP     NOT NULL
);

ALTER TABLE metadata
ADD CONSTRAINT metadata_unique_name UNIQUE (name);

Flyway执行完成后，name列类型为CITEXT，type为自定义枚举类型。但创建如下JPA实体类后：

@Entity
public class Metadata {
  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE)
  private Long id;

  @Column(nullable = false, unique = true)
  private String name;

  @Column(nullable = false)
  @Enumerated(EnumType.STRING)
  private MetadataType type;

  @CreatedDate
  @Column(updatable = false)
  private LocalDateTime createdAt;

  @LastModifiedDate
  private LocalDateTime updatedAt;
}

启动应用后，JPA自动将name列的CITEXT类型修改为VARCHAR，破坏了大小写不敏感的唯一性约束（此时"test"和"Test"可同时存在）。枚举类型改为VARCHAR可接受，但必须保留CITEXT的特性。以下是可行的解决办法：

方案1：禁用JPA自动修改表结构 #

通过配置关闭Hibernate的DDL自动更新功能，让Flyway全权管理表结构，避免JPA修改已创建好的字段类型。

在application.properties中添加：

spring.jpa.hibernate.ddl-auto=none

或application.yml中添加：

spring:
  jpa:
    hibernate:
      ddl-auto: none

该配置适用于生产环境，所有表结构变更需通过Flyway脚本执行。

方案2：自定义类型适配CITEXT #

如果需要保留JPA部分DDL功能，可通过自定义Hibernate类型实现String到PostgreSQL CITEXT的映射：

1. 添加Hibernate Types依赖（版本需与Spring Boot、Hibernate版本兼容）：

<!-- Maven -->
<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-55</artifactId>
    <version>2.19.0</version>
</dependency>

或Gradle依赖：

implementation 'com.vladmihalcea:hibernate-types-55:2.19.0'

2. 修改实体类中name字段的注解，指定映射类型：

@Entity
public class Metadata {
  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE)
  private Long id;

  @Column(nullable = false, unique = true, columnDefinition = "CITEXT")
  @Type(type = "com.vladmihalcea.hibernate.type.basic.CitextType")
  private String name;

  @Column(nullable = false)
  @Enumerated(EnumType.STRING)
  private MetadataType type;

  @CreatedDate
  @Column(updatable = false)
  private LocalDateTime createdAt;

  @LastModifiedDate
  private LocalDateTime updatedAt;
}

这样Hibernate会正确识别并映射CITEXT类型，不会将其改为VARCHAR。

临时方案补充说明 #

你之前采用的临时方案：用VARCHAR替代CITEXT，再创建大小写不敏感的唯一索引：

CREATE UNIQUE INDEX metadata_idx_unique_name ON metadata (LOWER(name));

该方案也能实现大小写不敏感的唯一性，但需注意在业务代码中插入/更新时，建议统一将name转为小写（或查询时使用LOWER(name)），避免数据不一致。不过相比原生CITEXT，这种方式需要额外的代码处理，CITEXT在数据库层面原生支持，更为简洁。

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