使用JPA @Converter转换自动生成int主键为String时的Hibernate报错问题

首先，你的核心矛盾点在于：数据库IDTECHX字段是int类型，但实体类中定义为String，同时使用了Hibernate的@SequenceGenerator来生成ID——而序列生成器默认会生成数值类型（比如Long或Integer），直接赋值给String类型的字段时，会跳过你配置的@Convert转换器，导致类型不匹配的Hibernate错误。

为什么会报错？ #

Hibernate的序列生成逻辑是在实体实例化阶段直接为字段赋值，这个过程不会触发属性转换器（Converter）——转换器只在实体和数据库之间做数据持久化/读取的转换，而序列生成的数值无法直接赋值给String类型的字段，这就是报错的核心原因。

解决方案 #

根据你的需求，这里有两种可行的修复方案：

方案1：调整实体类字段类型为数值类型，保留业务所需的String格式输出

如果你的业务只是需要对外返回String类型的ID，而非实体类内部必须用String存储，可以保持数据库字段为int，实体类字段改为Integer，然后通过Jackson的序列化配置来把数值ID转为String返回：

@JsonView(Views.Public.class)
@Id
@GeneratedValue(generator = "INC_IDTECHX", strategy = GenerationType.SEQUENCE)
@SequenceGenerator(name = "INC_IDTECHX", sequenceName = "INC_X", allocationSize = 1)
@Column(name = "IDTECHX", unique = true, nullable = false, precision = 8, scale = 0)
private Integer idtechX;

// 对外暴露String格式的ID，同时隐藏原数值类型的getter避免序列化重复
@JsonView(Views.Public.class)
@JsonProperty("idtechX")
public String getIdtechXAsString() {
    return idtechX != null ? idtechX.toString() : null;
}

@JsonIgnore
public Integer getIdtechX() {
    return idtechX;
}

方案2：自定义序列生成器，直接生成String类型的ID

如果你一定要让实体类字段保持String类型，可以自定义一个序列生成器，将序列生成的数值转为String后再赋值：

1. 先实现IdentifierGenerator接口：

public class StringSequenceGenerator implements IdentifierGenerator {
    @Override
    public Serializable generate(SharedSessionContractImplementor session, Object object) throws HibernateException {
        // 复用Hibernate的序列生成逻辑获取数值
        SequenceStyleGenerator delegate = new SequenceStyleGenerator();
        delegate.configure(LongType.INSTANCE, new Properties(), session.getFactory().getServiceRegistry());
        Long sequenceValue = (Long) delegate.generate(session, object);
        // 将数值转为String返回
        return sequenceValue.toString();
    }
}

2. 修改实体类的生成器配置：

@JsonView(Views.Public.class)
@Id
@GeneratedValue(generator = "STRING_INC_IDTECHX", strategy = GenerationType.SEQUENCE)
@GenericGenerator(
    name = "STRING_INC_IDTECHX",
    type = StringSequenceGenerator.class,
    parameters = {
        @Parameter(name = "sequence_name", value = "INC_X"),
        @Parameter(name = "allocation_size", value = "1")
    }
)
@Column(name = "IDTECHX", unique = true, nullable = false, precision = 8, scale = 0)
@Convert(converter = IntConverter.class) // 此时转换器可用于数据库读写的String与int转换
private String idtechX;

额外提醒 #

如果你的IntConverter是用来处理特殊的字符串转int逻辑（比如非纯数字字符串），那需要确保自定义序列生成器生成的String符合转换器的转换规则，否则持久化时还是会报错。如果只是单纯的数值转String/String转数值，方案1会更简洁，避免不必要的自定义逻辑。

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