JPA/Hibernate非自动生成ID替代方案及字符串ID插入异常问题

嘿，我看你在用String类型作为JPA实体的主键时遇到了保存异常的问题，结合你给出的代码片段，我整理了几个常见的原因和对应的解决办法，应该能帮到你：

1. 给主键显式指定生成策略 #

因为你是手动给String类型的主键赋值，得明确告诉JPA不需要自动生成主键值——默认情况下框架可能会尝试用数值型主键的生成策略（比如自增），这肯定会出问题。你可以在@Id注解上加上@GeneratedValue，指定策略为ASSIGNED（Hibernate支持）或者NONE：

@Entity
@Table(name = "xpto_version_map")
public class XptoVersionMap implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.ASSIGNED) // 用NONE也可以，看你用的JPA提供商
    @Column(name = "uniq_name", unique = true, nullable = false)
    private String uniq_name;

    // 记得保持getter和setter正确
    public void setUniqName(String uniqName) {
        this.uniq_name = uniqName;
    }
}

2. 检查字段映射的命名规则 #

你的实体字段是uniq_name（下划线命名），但setter是setUniqName（驼峰式），得确保JPA能正确识别这种映射关系。如果是用Spring Boot的话，可以在配置文件里加一行，让框架自动把驼峰转成下划线：

spring.jpa.hibernate.naming.implicit-strategy=org.hibernate.boot.model.naming.ImplicitNamingStrategyLegacyJpaImpl

当然你已经在@Column里明确指定了列名，这一步可能不是必须的，但确认一下总没坏处。

3. 核对数据库表的字段类型 #

要保证数据库里xpto_version_map表的uniq_name列是字符串类型（比如VARCHAR(255)或者TEXT），要是它是数值型或者其他不兼容的类型，保存的时候肯定会抛出类型转换的异常。

4. 排查是否存在重复主键 #

虽然你说保存的是新实例，但也有可能数据库里已经有uniq_name为"XPTO-1"的记录了。可以在保存前先查一下：

Optional<XptoVersionMap> existingRecord = xptoVersionMapRepository.findById("XPTO-1");
if (existingRecord.isPresent()) {
    // 这里可以处理重复的情况，比如更新现有记录或者提示用户
} else {
    xptoVersionMapRepository.save(xptoVersionMap);
}

如果是重复主键的话，JPA一般会抛出EntityExistsException之类的异常。

内容的提问来源于stack exchange，提问作者David Magalhães