Spring Data JPA @Convert引发ResultSet已关闭异常的解决问询

这个问题我之前帮同事排查过类似的，核心原因其实是你的TransitConverter在JPA遍历ResultSet的过程中，执行了会干扰数据库连接状态的外部HTTP调用（Feign请求Vault），导致数据库连接被提前释放，ResultSet自然就没法继续读取后续数据了。

为什么会出现这个异常？ #

JPA在执行查询并返回结果列表时，默认是懒加载遍历ResultSet——也就是说，它不会一次性把所有数据捞到内存里，而是保持数据库连接打开，逐条读取ResultSet中的记录。这时候如果你的Converter在convertToEntityAttribute（解密）方法里直接调用Feign客户端：

1. Feign调用是个独立的HTTP请求，会触发Spring的上下文切换；
2. 如果你的Feign方法或者调用链上有事务注解（哪怕是默认的REQUIRED），Spring可能会挂起当前的JPA事务，把数据库连接归还给连接池；
3. 当回到JPA继续读取下一条记录时，ResultSet已经因为连接关闭而失效，直接抛出「Operation not allowed after ResultSet closed」异常。

怎么解决？ #

这里给你三个可行的方案，按推荐度排序：

1. 把解密操作移出Converter，改为批量处理（最稳妥）

放弃用@Convert自动解密，先查询出所有加密后的记录，再批量调用Vault解密。这样ResultSet遍历完成后再处理外部请求，完全不会影响数据库连接。

示例代码：

// 先修改TaskCommentModel，去掉@Convert注解，直接存加密字符串
@Entity
public class TaskCommentModel {
    @Id
    private Long id;
    // 存储加密后的评论
    private String encryptedComment;
    // 临时存储解密后的内容（用@Transient标记，不映射到数据库）
    @Transient
    private String comment;
    // getter/setter...
}

// 在Service层完成查询+批量解密
@Service
public class TaskCommentService {
    private final TaskCommentRepository commentRepo;
    private final VaultFeignClient vaultClient;

    // 构造注入
    public TaskCommentService(TaskCommentRepository commentRepo, VaultFeignClient vaultClient) {
        this.commentRepo = commentRepo;
        this.vaultClient = vaultClient;
    }

    public List<TaskCommentModel> getDecryptedComments() {
        // 先查询所有加密记录，此时ResultSet已经遍历完成，连接已释放
        List<TaskCommentModel> comments = commentRepo.findAll();
        
        // 收集所有加密字符串，批量调用Vault解密（尽量用批量接口减少HTTP请求）
        List<String> encryptedTexts = comments.stream()
                .map(TaskCommentModel::getEncryptedComment)
                .collect(Collectors.toList());
        Map<String, String> decryptResult = vaultClient.batchDecrypt(encryptedTexts);
        
        // 把解密后的值回填到实体
        comments.forEach(comment -> 
                comment.setComment(decryptResult.get(comment.getEncryptedComment())));
        
        return comments;
    }
}

2. 配置Feign调用的事务传播策略（可选，需测试）

如果一定要保留@Convert的自动解密，可以给Feign客户端的方法配置事务传播为NOT_SUPPORTED，强制Feign调用不使用事务，避免干扰当前的JPA连接。

示例：

@FeignClient(name = "vault-service")
public interface VaultFeignClient {
    @PostMapping("/api/vault/decrypt")
    // 告诉Spring这个方法不需要事务，避免挂起当前JPA的事务
    @Transactional(propagation = Propagation.NOT_SUPPORTED)
    String decrypt(@RequestBody String encryptedText);
}

⚠️ 注意：这种方式依赖你的连接池配置和Spring事务管理的细节，有些场景下可能还是会出现连接被回收的问题，不如第一种方案可靠。

3. 启用OpenEntityManagerInViewFilter（不推荐高并发场景）

如果是Web应用，你可以配置OpenEntityManagerInViewFilter，让EntityManager在整个HTTP请求周期内保持打开，这样ResultSet就不会提前关闭。但这个方式会让数据库连接占用时间变长，容易导致连接池耗尽，只适合低并发场景。

配置示例（Spring Boot）：

@Configuration
public class WebConfig {
    @Bean
    public OpenEntityManagerInViewFilter openEntityManagerInViewFilter() {
        return new OpenEntityManagerInViewFilter();
    }
}

总结 #

最核心的原则是：不要在JPA遍历ResultSet的过程中执行外部IO操作（不管是HTTP请求还是其他远程调用），因为这会干扰数据库连接的生命周期。优先选择批量解密的方案，既稳定又能减少HTTP请求次数，性能也更好。

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