PostgreSQL Testcontainer中初始化脚本前创建表空间目录的方法
实现方案
要解决这个问题,核心是保证表空间对应的目录在执行创建表空间的SQL脚本前,已经在容器内创建完成并配置正确权限。PostgreSQL有强制校验规则:表空间目录必须存在、为空、属主为postgres运行用户、权限为700,否则CREATE TABLESPACE语句会直接报错。
以下是两种最常用的实现方式:
方式一:利用Postgres镜像内置的init脚本机制(零侵入Java逻辑)
PostgreSQL官方镜像的启动流程中,会自动执行容器内/docker-entrypoint-initdb.d目录下的初始化内容,执行顺序为:
- 执行目录下所有后缀为
.sh的shell脚本 - 按文件名字母顺序,执行所有后缀为
.sql的初始化脚本
基于这个特性,我们只需要新增一个简单的shell初始化脚本,就可以保证目录创建的时机早于SQL脚本执行: - 在测试资源目录(也就是
init-database-test.sql所在的resources路径下)新增shell脚本,命名为00-init-tablespace-dir.sh(前缀加00-是为了保证脚本按字母排序时早于init-database-test.sql执行),脚本内容为:#!/bin/bash set -e # 创建所有表空间对应的空目录 mkdir -p /tsd01 /tsi01 /tsisecurity01 # 调整目录属主为PostgreSQL运行用户、设置符合要求的权限 chown -R postgres:postgres /tsd01 /tsi01 /tsisecurity01 chmod 700 /tsd01 /tsi01 /tsisecurity01 - 修改Testcontainer定义,将这个shell脚本注册为初始化脚本:
public static PostgreSQLContainer<?> postgreDBContainer = new PostgreSQLContainer<>("postgres:12") // 先执行shell脚本创建目录 .withInitScript("00-init-tablespace-dir.sh") // 后执行原有的建表空间SQL .withInitScript("init-database-test.sql") .withUsername("dba") .withPassword("dba");
方式二:通过Testcontainers的启动钩子执行目录创建(无额外资源文件)
如果不想在测试资源目录下新增shell脚本,可以直接利用Testcontainers提供的启动动作钩子,在数据库初始化脚本执行前,向容器发送命令创建目录:
public static PostgreSQLContainer<?> postgreDBContainer = new PostgreSQLContainer<>("postgres:12") .withInitScript("init-database-test.sql") .withUsername("dba") .withPassword("dba") // 注册启动动作:在所有初始化SQL脚本执行前运行 .withStartupActions(container -> { // 容器内执行创建目录、调整权限的命令 var execResult = container.execInContainer( "bash", "-c", "mkdir -p /tsd01 /tsi01 /tsisecurity01 && " + "chown -R postgres:postgres /tsd01 /tsi01 /tsisecurity01 && " + "chmod 700 /tsd01 /tsi01 /tsisecurity01" ); // 校验命令执行结果,失败直接抛出异常避免后续流程报错 if (execResult.getExitCode() != 0) { throw new IllegalStateException("创建表空间目录失败: " + execResult.getStderr()); } });
注意:
withStartupActions的执行时机是Testcontainers确认数据库端口可连通后、所有注册的初始化SQL脚本执行前,完全满足目录创建的时序要求。
常见踩坑点
- 不要给表空间目录设置755/777这类过于开放的权限,PostgreSQL的安全校验会直接拒绝在这类目录下创建表空间
- 不要在创建目录时提前写入任何文件,PostgreSQL要求表空间对应目录必须为空
- 必须将目录属主设置为
postgres:postgres,如果属主是root,PostgreSQL会因为权限问题拒绝关联目录
内容的提问来源于stack exchange,提问作者Marcus Hert da Coregio
相关产品推荐
相关产品推荐

