使用TestContainer PostgreSQL模块运行Jest测试时遇容器运行时策略错误

以下是针对该报错的排查和解决步骤：

• 确认Docker daemon处于运行状态
  TestContainers依赖Docker后台服务，即使已安装Docker，若服务未启动也会触发该错误。

  • Windows/macOS：打开Docker Desktop，确认界面显示“Running”状态。
  • Linux：执行sudo systemctl status docker检查服务状态，未运行则执行sudo systemctl start docker启动。

• 修复Linux下Docker用户权限
  Linux系统中普通用户默认无Docker访问权限，导致TestContainers无法调用Docker API。执行以下命令将当前用户加入docker组：

  sudo usermod -aG docker $USER
  

  执行后需重新登录终端或重启系统，确保权限生效。

• 手动指定Docker Socket路径
  部分场景下TestContainers无法自动识别Docker Socket路径，可手动指定：

  import { PostgreSqlContainer } from "@testcontainers/postgresql";
  
  beforeAll(async () => {
    const container = await new PostgreSqlContainer()
      // Linux/macOS使用此路径；Windows替换为"//./pipe/docker_engine"
      .withDockerSocketPath("/var/run/docker.sock")
      .start();
    // 后续测试逻辑
  });
  

• 更新TestContainers依赖版本
  旧版本TestContainers可能存在容器运行时检测逻辑的bug，尝试更新至最新稳定版：

  npm update @testcontainers/postgresql @testcontainers/core
  

• 配置Jest使用Node环境
  Jest默认的jsdom环境会干扰TestContainers的运行，需确保测试使用Node环境：

  • 单文件配置：在测试文件顶部添加注释

    /**
     * @jest-environment node
     */
    

  • 全局配置：在jest.config.js中修改

    module.exports = {
      testEnvironment: "node"
    };
    

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