使用Testcontainers运行Oracle XE 11.2.0.2镜像时初始化脚本执行失败

问题根源 #

Oracle XE 11g的默认数据库服务名是XE，而Testcontainers的OracleContainer对部分镜像可能默认使用了不匹配的服务名（比如ORCL），导致JDBC连接时监听器无法识别请求的服务。同时你的代码中存在环境变量冲突，也会加剧连接问题。

具体解决步骤 #

1. 显式指定JDBC连接的服务名 #

覆盖OracleContainer的getJdbcUrl()方法，强制使用XE作为服务名，确保连接描述符与容器内的数据库服务匹配：

final OracleContainer container = new OracleContainer("gvenzl/oracle-xe:11.2.0.2-slim-faststart") {
    @Override
    public String getJdbcUrl() {
        // 强制使用XE作为服务名，适配Oracle XE 11g的默认配置
        return String.format("jdbc:oracle:thin:@%s:%d:%s", getHost(), getOraclePort(), "XE");
    }

    @Override
    protected void configure() {
        if (!getEnvMap().containsKey("ORACLE_PASSWORD"))
            withEnv("ORACLE_PASSWORD", getPassword());

        if (!getEnvMap().containsKey("APP_USER"))
            withEnv("APP_USER", getUsername());

        if (!getEnvMap().containsKey("APP_USER_PASSWORD"))
            withEnv("APP_USER_PASSWORD", getPassword());

        // Oracle XE 11g默认数据库就是XE，无需额外设置ORACLE_DATABASE，注释掉原有逻辑避免冲突
    }
}
.withInitScript("init.sql")
.withReuse(true)
.withUsername("ORACLEXE")
.withPassword("oraclexe123")
.withEnv("ORACLE_PASSWORD", "oraclexe")
.withEnv("APP_USER", "ORACLEXE")
.withEnv("APP_USER_PASSWORD", "oraclexe123");

container.start();

2. 清理冲突的环境变量 #

你的代码中同时使用了withPassword("oraclexe123")和withEnv("ORACLE_PASSWORD", "oraclexe")，需明确两者的区别：

• ORACLE_PASSWORD是容器内SYS/SYSTEM用户的密码
• withPassword()设置的是Testcontainers执行初始化脚本所用用户的密码
  如果用ORACLEXE（默认SYS用户）执行脚本，需确保这两个密码一致，避免权限验证失败。

3. 验证初始化脚本的上下文 #

确保init.sql中的操作针对正确的服务和用户，可在脚本开头添加切换语句：

ALTER SESSION SET CURRENT_SCHEMA = ORACLEXE;

4. 临时禁用容器复用排查 #

如果开启了withReuse(true)，可能复用了之前状态异常的容器。临时注释该配置，重新启动容器，排除复用带来的遗留问题。

额外验证操作 #

手动进入容器检查监听器状态，确认服务名注册正常：

# 进入运行中的容器
docker exec -it <容器ID> bash
# 查看监听器注册的服务列表
lsnrctl status

确认输出中包含XE服务条目，确保连接描述符与实际服务匹配。

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