如何在JPA/Hibernate中拦截EntityNotFoundException并返回假实体

针对遗留系统无外键约束导致的关联实体缺失问题，有几种可行的解决方式：

1. 使用Hibernate专属@NotFound注解 #

这是最简便的方案，通过Hibernate的@NotFound注解告诉框架忽略不存在的关联实体，直接将关联字段设为null，不会抛出异常。

示例代码：

@Entity
public class Order {
    // 其他字段...

    @ManyToOne
    @NotFound(action = NotFoundAction.IGNORE) // 核心配置
    @JoinColumn(name = "customer_id")
    private Customer customer;

    // getter/setter...
}

• 优点：代码侵入性低，无需额外逻辑
• 缺点：属于Hibernate扩展，不兼容其他JPA实现

2. 自定义Hibernate拦截器返回"假实体" #

如果需要返回默认的假实体而非null，可以通过Hibernate的Interceptor拦截加载失败的关联，手动构造默认实体。

示例拦截器实现：

public class MissingEntityInterceptor extends EmptyInterceptor {
    @Override
    public boolean onLoad(Object entity, Serializable id, Object[] state, String[] propertyNames, Type[] types) {
        // 假设Order的customer字段加载失败时触发
        if (entity instanceof Order) {
            Order order = (Order) entity;
            if (order.getCustomer() == null) {
                // 构造假实体
                Customer fakeCustomer = new Customer();
                fakeCustomer.setId(-1L);
                fakeCustomer.setName("未知客户");
                order.setCustomer(fakeCustomer);
            }
        }
        return super.onLoad(entity, id, state, propertyNames, types);
    }
}

然后在配置类中注册拦截器：

@Bean
public LocalSessionFactoryBean sessionFactory() {
    LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
    // 其他配置...
    sessionFactory.setInterceptor(new MissingEntityInterceptor());
    return sessionFactory;
}

• 优点：高度自定义，可返回任意默认实体
• 缺点：需要熟悉Hibernate拦截器机制，逻辑相对复杂

3. 手动控制查询逻辑（JPQL左连接） #

在查询时显式使用LEFT JOIN FETCH代替默认的内连接，确保即使关联实体不存在，查询也能正常返回，关联字段为null。

示例JPQL：

String jpql = "SELECT o FROM Order o LEFT JOIN FETCH o.customer WHERE o.id = :orderId";
Order order = entityManager.createQuery(jpql, Order.class)
    .setParameter("orderId", orderId)
    .getSingleResult();

• 优点：符合JPA标准，兼容所有JPA实现
• 缺点：需要修改所有涉及该关联的查询语句

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