Hibernate/JPA：创建外部对象匹配已有持久化实体自动填充关联字段

默认情况下，JPA/Hibernate不会自动通过非ID字段（比如你的bazname）匹配瞬时态实体和数据库中已有的持久化对象。因为JPA的关联逻辑默认依赖实体的@Id标识符，你创建的new Baz("someotherthing")是未设置bazkey的瞬时对象，框架无法识别它对应数据库里的哪条记录。

不过你可以通过以下几种方式实现需求：

1. 使用自然ID（NaturalId）匹配 #

给Baz的name字段标记为自然ID，利用JPA/Hibernate的自然ID查询能力获取持久化实例，再关联到Thing上。

步骤1：修改Baz实体，标记自然ID #

@Data
@Entity
@Table(name = "baztable")
public class Baz {
    @Id
    private int bazkey;

    @NaturalId // 标记为自然ID
    @Column(name = "bazname", unique = true) // 确保name唯一，符合自然ID的唯一性要求
    private String name;
}

步骤2：通过自然ID获取持久化Baz并关联 #

在保存Thing前，先通过name查询到数据库中已有的Baz实例，再赋值给Thing的baz属性：

@Service
public class ThingService {
    private final ThingRepository thingRepository;
    private final BazRepository bazRepository;

    public ThingService(ThingRepository thingRepository, BazRepository bazRepository) {
        this.thingRepository = thingRepository;
        this.bazRepository = bazRepository;
    }

    public Thing createThing(String thingName, String bazName) {
        Thing thing = new Thing();
        thing.setName(thingName);
        
        // 通过name查询已有Baz，不存在则抛出异常
        Baz existingBaz = bazRepository.findByName(bazName)
                .orElseThrow(() -> new IllegalArgumentException("找不到名称为" + bazName + "的Baz记录"));
        
        thing.setBaz(existingBaz);
        return thingRepository.save(thing);
    }
}

对应的BazRepository接口：

public interface BazRepository extends JpaRepository<Baz, Integer> {
    Optional<Baz> findByName(String name);
}

如果使用Hibernate原生API，还可以用更高效的自然ID加载方法：

// 假设已获取到Session对象
Baz existingBaz = session.byNaturalId(Baz.class)
        .using("name", "someotherthing")
        .load();

2. 利用@PrePersist注解预处理 #

在Thing实体中添加@PrePersist方法，在持久化前自动查询匹配的Baz实例替换瞬时对象。

实现代码 #

@Data
@Entity
@Table(name = "thingtable")
public class Thing {
    @Id
    private int thingkey;

    @Column(name = "thingname")
    private String name;

    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name = "bazkey", referencedColumnName = "bazkey")
    private Baz baz;

    // 注意：这里需要通过Spring上下文获取Repository，直接注入会有生命周期问题
    @Transient
    private BazRepository bazRepository;

    // 注入Repository的方法，可通过Spring的ApplicationContextAware实现，或者在Service层设置
    public void setBazRepository(BazRepository bazRepository) {
        this.bazRepository = bazRepository;
    }

    @PrePersist
    public void prePersist() {
        if (baz != null && baz.getBazkey() == 0) {
            Baz existingBaz = bazRepository.findByName(baz.getName())
                    .orElseThrow(() -> new IllegalArgumentException("Baz记录不存在: " + baz.getName()));
            this.baz = existingBaz;
        }
    }
}

这种方式可以让你保持thing.setBaz(new Baz("someotherthing"))的写法，但需要注意Repository的注入方式（避免实体中直接依赖Spring Bean的生命周期问题）。

3. 自定义Repository的save方法 #

在ThingRepository中实现自定义的save逻辑，替换瞬时态的Baz为持久化实例：

public interface ThingRepository extends JpaRepository<Thing, Integer>, ThingRepositoryCustom {
}

// 自定义实现类
public class ThingRepositoryImpl implements ThingRepositoryCustom {
    @PersistenceContext
    private EntityManager entityManager;

    @Override
    public <S extends Thing> S save(S thing) {
        if (thing.getBaz() != null && thing.getBaz().getBazkey() == 0) {
            // 通过JPQL查询匹配的Baz
            TypedQuery<Baz> query = entityManager.createQuery(
                    "SELECT b FROM Baz b WHERE b.name = :name", Baz.class);
            query.setParameter("name", thing.getBaz().getName());
            Baz existingBaz = query.getSingleResult();
            thing.setBaz(existingBaz);
        }
        return entityManager.merge(thing);
    }
}

这样调用thingRepository.save(thing)时，框架会自动处理Baz的匹配逻辑。

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