如何在JPA中将TEXT设置为String类型的默认字段类型？

以下三种方案都可以实现无需给每个String字段加@Column(columnDefinition = "TEXT")注解，按需选择即可： #

方案1：自定义Hibernate PostgreSQL方言（推荐，全局无侵入） #

该方案通过修改Hibernate的字段类型映射规则实现全局生效，不需要修改任何实体类代码：

1. 新建自定义方言类，继承你当前使用的PostgreSQL版本对应的方言：

import org.hibernate.dialect.PostgreSQLDialect
import java.sql.Types

class CustomPostgreSQLDialect : PostgreSQLDialect() {
    init {
        // 替换默认VARCHAR映射为TEXT
        registerColumnType(Types.VARCHAR, "text")
    }
}

2. 在项目配置文件中指定使用自定义方言，以application.yml为例：

spring:
  jpa:
    properties:
      hibernate:
        dialect: com.your.project.package.CustomPostgreSQLDialect

方案2：包级别TypeDef配置（可控制生效范围） #

如果不需要全局所有模块生效，只想给指定包下的实体类应用该规则，可以用Hibernate的@TypeDef注解做包级配置：
在实体类所在包下创建package-info.kt文件，内容如下：

@TypeDef(
    name = "text",
    typeClass = org.hibernate.type.TextType::class,
    defaultForType = String::class
)
package com.your.project.entity

import org.hibernate.annotations.TypeDef

方案3：JPA标准属性转换器（不依赖Hibernate特性） #

如果需要遵循JPA标准、不绑定Hibernate私有实现，可以用自动生效的属性转换器：

import jakarta.persistence.AttributeConverter
import jakarta.persistence.Converter

@Converter(autoApply = true)
class StringToTextConverter : AttributeConverter<String, String> {
    override fun convertToDatabaseColumn(attribute: String?): String? = attribute
    override fun convertToEntityAttribute(dbData: String?): String? = dbData
}

该配置会自动对所有String类型字段生效，结合PostgreSQL的类型兼容特性，最终生成的字段类型为TEXT。 #

注意事项 #

• 如果已经有线上存量表使用varchar(255)类型，修改配置后如果开启了hibernate.ddl-auto: update，Hibernate会自动将字段转换为TEXT类型，PostgreSQL支持该无损转换，建议上线前先备份数据做测试。
• 特殊场景需要指定字段长度的，依然可以单独加@Column(length = xxx)覆盖全局配置，不会冲突。

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