如何用JPA实现多实体多语言名称单表存储结构？

这个共享I18n表的设计思路很实用，我来帮你落地实现它。核心需要解决复合主键定义和跨实体关联这两个问题，具体步骤如下：

1. 定义I18n的复合主键 #

因为entity_id + lan是I18n表的唯一标识，所以需要先创建一个嵌入式主键类（JPA要求复合主键必须实现Serializable）：

@Embeddable
public class I18nId implements Serializable {
    private UUID entityId;
    @Column(length = 2)
    private String lan;

    // JPA强制要求无参构造器
    public I18nId() {}

    // 便捷构造器
    public I18nId(UUID entityId, String lan) {
        this.entityId = entityId;
        this.lan = lan;
    }

    // 必须重写equals和hashCode，用于JPA识别主键唯一性
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        I18nId i18nId = (I18nId) o;
        return Objects.equals(entityId, i18nId.entityId) && Objects.equals(lan, i18nId.lan);
    }

    @Override
    public int hashCode() {
        return Objects.hash(entityId, lan);
    }

    // 生成getter和setter方法
}

2. 重构I18n实体类 #

基于复合主键修改I18n实体，同时强烈建议添加entityType字段——虽然UUID重复概率极低，但这个字段能彻底避免不同实体类型（比如Product和Category）的ID冲突问题：

@Entity
public class I18n {
    @EmbeddedId
    private I18nId id;

    private String name;

    // 用于区分是Product还是Category的多语言记录
    @Column(length = 20)
    private String entityType;

    // 无参构造器
    public I18n() {}

    // 便捷构造器
    public I18n(UUID entityId, String lan, String name, String entityType) {
        this.id = new I18nId(entityId, lan);
        this.name = name;
        this.entityType = entityType;
    }

    // 生成getter和setter方法
}

3. 关联Product与I18n #

在Product实体中配置一对多关联，并用@Where注解过滤仅属于Product的I18n记录：

@Entity
public class Product {
    @Id
    @GeneratedValue
    private UUID id;

    // LAZY加载优化性能，避免每次查询都加载所有多语言名称
    @OneToMany(fetch = FetchType.LAZY)
    @JoinColumn(name = "entity_id", referencedColumnName = "id", insertable = false, updatable = false)
    // 只加载Product类型的多语言记录
    @Where(clause = "entity_type = 'PRODUCT'")
    private List<I18n> names = new ArrayList<>();

    // 无参构造器
    public Product() {}

    // 业务方法：根据语言快速获取对应名称
    public String getName(String lan) {
        return names.stream()
                .filter(i18n -> lan.equals(i18n.getId().getLan()))
                .map(I18n::getName)
                .findFirst()
                .orElse(null); // 可替换为默认名称，比如英文名称
    }

    // 生成getter和setter方法
}

4. 关联Category与I18n #

和Product的实现几乎一致，仅需修改@Where的过滤条件：

@Entity
public class Category {
    @Id
    @GeneratedValue
    private UUID id;

    @OneToMany(fetch = FetchType.LAZY)
    @JoinColumn(name = "entity_id", referencedColumnName = "id", insertable = false, updatable = false)
    @Where(clause = "entity_type = 'CATEGORY'")
    private List<I18n> names = new ArrayList<>();

    public Category() {}

    public String getName(String lan) {
        return names.stream()
                .filter(i18n -> lan.equals(i18n.getId().getLan()))
                .map(I18n::getName)
                .findFirst()
                .orElse(null);
    }

    // 生成getter和setter方法
}

关键注意事项 #

• 复合主键规则：复合主键类必须实现Serializable，且正确重写equals和hashCode，否则JPA无法正确识别主键唯一性。
• 关联维护限制：设置insertable = false, updatable = false是因为I18n的主键由entity_id和lan共同组成，不能通过Product/Category修改关联字段，否则会导致JPA生成错误的SQL。
• 加载策略：FetchType.LAZY是默认推荐的加载方式，若需要在事务外获取多语言名称，记得提前初始化（比如用entityManager.fetch(product.getNames())）。

数据插入示例 #

// 开启事务
EntityManager entityManager = ...;
entityManager.getTransaction().begin();

// 创建并保存Product
Product product = new Product();
entityManager.persist(product);

// 添加中文名称
I18n productZhName = new I18n(product.getId(), "zh", "无线耳机", "PRODUCT");
entityManager.persist(productZhName);

// 添加英文名称
I18n productEnName = new I18n(product.getId(), "en", "Wireless Headphones", "PRODUCT");
entityManager.persist(productEnName);

// 创建并保存Category
Category category = new Category();
entityManager.persist(category);

// 添加分类的多语言名称
I18n categoryZhName = new I18n(category.getId(), "zh", "数码产品", "CATEGORY");
entityManager.persist(categoryZhName);

entityManager.getTransaction().commit();

内容的提问来源于stack exchange，提问作者nagy.zsolt.hun