JUnit集成测试出现PostgreSQL缓存计划结果类型变更错误的原因咨询

问题背景 #

我用TestContainers搭配JUnit做Spring应用的集成测试，定义了静态PostgreSQL容器：

protected static final PostgreSQLContainer<?> container = new PostgreSQLContainer<>("postgres:14-alpine");

同时用@BeforeEach方法在每次测试前清理数据库并重新执行Flyway迁移。之前测试一切正常，直到添加了这段SQL迁移脚本：

CREATE TYPE user_state_enum AS ENUM ('ACTIVE', 'DELETED');

ALTER TABLE users ALTER COLUMN user_state TYPE user_state_enum; -- 原字段为text类型

之后部分测试执行userRepository.findByUserId(userId)时，反复抛出错误：

org.postgresql.util.PSQLException: ERROR: cached plan must not change result type

我已经按要求修改了实体类，继承org.hibernate.type.EnumType实现了nullSafeSet方法，但错误依旧，最后通过在application-test.yaml中添加配置解决：

spring:
  datasource:
    hikari:
      data-source-properties:
        preparedStatementCacheQueries: 0

错误原因 #

这个问题的核心是预编译语句缓存与数据库元数据变更的冲突：

• 你的@BeforeEach逻辑会在每次测试前重建schema并执行迁移，这意味着同一数据库连接在不同测试周期内，面对的表结构是变化的（从text字段变成enum字段）
• Hikari连接池默认会缓存预编译语句，第一个测试执行findByUserId时，PostgreSQL生成了针对text字段的查询计划并缓存
• 后续测试执行迁移后字段类型变更，但连接池复用了之前的连接，缓存的旧预编译语句依然指向原text类型的字段，执行时就会触发"结果类型不匹配"的错误
• Flyway确实是在测试前执行，但你是每次测试都重复执行迁移+重建schema，这才是关键——不是Flyway执行时机的问题，而是测试过程中数据库元数据被反复修改，而缓存的预编译语句没有同步更新

方案解释与其他可选思路 #

你设置的preparedStatementCacheQueries: 0直接禁用了Hikari的预编译语句缓存，这样每次查询都会重新生成预编译语句，自然不会出现旧缓存与新结构不匹配的问题。

另外还有两种可选思路：

• 重置连接池：在@AfterEach方法中调用DataSourceUtils.resetDataSource(dataSource)，强制连接池丢弃当前测试用过的连接，下次测试使用全新连接，避免复用带旧缓存的连接
• 调整测试清理策略：如果迁移脚本不会频繁变更，不要在@BeforeEach里全量重建schema，改用TRUNCATE TABLE仅清理数据——这样数据库元数据保持稳定，缓存的预编译语句依然有效，测试效率也更高

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