Hibernate主键类(xxxPK.java)的作用与适用场景及LOG表设计咨询

API 探路者

2026-8-13

Hibernate主键类的作用与适用场景

核心作用：专门用来处理复合主键的映射需求——当数据库表用多个字段联合起来唯一标识一条记录时，主键类能让Hibernate正确识别并处理这个多字段主键的逻辑；另外在很早的Hibernate版本里，部分特殊主键类型的映射可能依赖主键类，但现在基本用不上了。
适用场景：
- 数据库表采用复合主键（多字段联合做主键）时，必须定义对应的主键类，这个类需要实现Serializable接口，同时重写equals()和hashCode()方法，保证主键的唯一性判断逻辑正确。
- 极早期Hibernate版本中，若主键有特殊生成逻辑且无法通过注解直接配置，可能会用到主键类，但这种场景现在已经几乎不存在。

针对你的LOG表的具体建议

你的LOG表中，ID是Oracle序列生成的单字段主键，TRANS_ID只是带有唯一约束的普通业务字段，并不是主键的一部分，所以完全不需要定义LogPK.java，没必要额外增加类。

你可以直接这样实现：

在Log实体类中，给ID字段配置主键注解即可：

@Entity
@Table(name = "LOG")
public class Log implements Serializable {
    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "log_seq")
    @SequenceGenerator(name = "log_seq", sequenceName = "你的Oracle序列名称", allocationSize = 1)
    @Column(name = "ID")
    private Long id;

    @Column(name = "TRANS_ID", unique = true, length = 40)
    private String transId;

    // 其他字段、getter/setter方法、构造函数等
}