如何让Testcontainers使用本地Docker镜像？

这种情况太常见了——明明本地已经有同名镜像，Testcontainers却还是执着去远程仓库拉取。别担心，这几个方法能帮你强制它优先用本地镜像：

1. 给单个容器设置拉取策略 #

这是最直接的做法，通过withImagePullPolicy把拉取策略设为PullPolicy.NEVER，明确告诉Testcontainers：“就用本地的，不许去远程拉！”

代码示例：

new GenericContainer("rserver:latest")
    .withImagePullPolicy(PullPolicy.NEVER)
    // 这里加你的其他容器配置

2. 全局配置拉取策略（所有容器生效） #

如果想让所有Testcontainers创建的容器都默认用本地镜像，可以通过系统属性全局设置：

• 启动程序时添加JVM参数：-Dtestcontainers.pull-policy=never
• 或者在代码里提前设置：

System.setProperty("testcontainers.pull-policy", "never");

3. 确认本地镜像标签完全匹配 #

有时候Testcontainers拉取是因为本地镜像的标签和你代码里指定的不完全一致。先检查本地镜像：

docker images | grep rserver

如果标签不对，重新打个和代码里一致的标签：

docker tag 你的本地镜像ID rserver:latest

4. 直接用本地镜像ID创建容器（终极方案） #

要是上面的方法都不好使，直接用本地镜像的ID来创建容器，Testcontainers绝对只会用本地的：

new GenericContainer("sha256:abcdef123456...") // 替换成你的镜像实际ID
    // 其他配置项

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