如何让Hibernate获取不存在关联用户时返回null而非抛出异常？

原因说明 #

你遇到的ObjectNotFoundException是因为Hibernate默认在加载关联实体（比如这里的User）时，如果数据库中没有对应记录，会直接抛出异常，而不是返回null。你的判断session.getCreatedBy() == null根本没机会执行，因为调用这个方法时就已经触发异常了。

可行解决方案 #

1. 修改实体映射配置，让Hibernate忽略缺失的关联对象 #

在Session实体类中，针对createdBy这个关联字段，添加@NotFound注解并设置action = NotFoundAction.IGNORE，这样Hibernate找不到对应User时会返回null，而非抛出异常。

示例代码：

@Entity
@Table(name = "ad_session")
public class Session {
    // 其他字段...
    
    @ManyToOne
    @JoinColumn(name = "created_by_id")
    @NotFound(action = NotFoundAction.IGNORE) // 关键配置
    private User createdBy;
    
    // getter、setter...
}

之后修改业务代码，正常判断null即可：

List<Session> sessions = getAllSuccessfulSessionsInTable();
List<Client> clientsForThatDay = new ArrayList<>();

// 创建替代对象
Client deletedUserClient = new Client();
deletedUserClient.setName("Unknown Client");

for (Session session : sessions) {
    User user = session.getCreatedBy();
    Client userClient;
    if (user == null) {
        userClient = deletedUserClient;
    } else {
        userClient = user.getClient();
        // 额外判断用户的Client也可能不存在的情况
        if (userClient == null) {
            userClient = deletedUserClient;
        }
    }
    clientsForThatDay.add(userClient);
}

2. 使用左外连接查询，提前加载关联对象 #

在查询Session的时候，用左外连接同时加载User和Client，这样即使User不存在，查询结果中对应的createdBy就是null，避免后续懒加载时抛异常。

比如用JPQL实现getAllSuccessfulSessionsInTable()：

String jpql = "SELECT s FROM Session s LEFT JOIN FETCH s.createdBy u LEFT JOIN FETCH u.client WHERE s.status = 'SUCCESS'";
List<Session> sessions = entityManager.createQuery(jpql, Session.class).getResultList();

之后的业务逻辑可直接沿用上面的null判断代码，不会再触发异常。

3. 在循环内部捕获特定异常，不中断整个流程 #

如果不想修改映射或查询语句，可以把try-catch放到循环内部，单独处理每个Session的加载异常，单个会话出错不会影响其他会话的处理。

示例代码：

List<Session> sessions = getAllSuccessfulSessionsInTable();
List<Client> clientsForThatDay = new ArrayList<>();
Client deletedUserClient = new Client();
deletedUserClient.setName("Unknown Client");

for (Session session : sessions) {
    try {
        User user = session.getCreatedBy();
        Client userClient = user.getClient();
        clientsForThatDay.add(userClient);
    } catch (ObjectNotFoundException e) {
        // 捕获用户不存在的异常，添加替代客户端
        clientsForThatDay.add(deletedUserClient);
        log.error("User not found for session: {}", session.getId(), e);
    } catch (Exception e) {
        // 处理其他异常
        log.error("Error processing session: {}", session.getId(), e);
    }
}

注意事项 #

• 方案1的@NotFound是Hibernate特有的注解，若使用纯JPA标准实现，优先考虑方案2。
• 方案2的左连接查询既解决异常问题，还能避免N+1查询的性能损耗，推荐优先使用。
• 所有方案都建议额外判断User的Client是否为null，避免后续触发类似异常。

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