Java实体类@Id注解字段是否需唯一？附多字段主键查询需求

1. 多个@Id注解字段的唯一性要求 #

在JPA规范中，如果实体类用多个@Id注解标记字段（即不用@EmbeddedId的复合主键实现方式），这些字段的组合值必须在数据库表中唯一。JPA会将这类字段视为复合主键处理，单个@Id字段的值可以重复，但所有@Id字段的组合值不能重复。即便数据库表未声明主键，JPA仍会从逻辑层面校验这些字段组合的唯一性，操作重复组合值时可能触发主键冲突异常。

2. 不用@EmbeddedId实现单字段查询的方案 #

如果数据库表无主键，且仅需通过单个字段查询匹配数据集，不建议使用多个@Id注解（会被JPA强制当作复合主键限制逻辑），推荐以下做法：

• 移除所有@Id注解，用@Column标记字段，无需指定主键。
• 若需提升目标字段的查询效率，可在该字段上添加@Index注解（Hibernate等主流JPA实现支持）。
• 查询时直接基于目标字段编写逻辑，比如JPQL语句：SELECT e FROM YourEntity e WHERE e.targetField = :value，或使用Spring Data JPA的派生查询方法。

3. @EmbeddedId未达预期的排查方向 #

若之前尝试@EmbeddedId未得到预期效果，可能是以下原因导致：

• 嵌入式主键类未正确定义：必须实现Serializable接口，且重写equals()和hashCode()方法。
• 实体类关联嵌入式主键有误：需用@EmbeddedId标记主键字段，若要单独访问主键内的某个字段，需配合@AttributeOverrides或@AttributeOverride指定数据库列名映射。
• 查询逻辑未适配复合主键：使用@EmbeddedId时，查询需传入完整的主键对象，或通过JPQL访问主键字段的属性，比如SELECT e FROM YourEntity e WHERE e.id.targetField = :value。

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