Docker容器中Lerna并发执行时Jest参数错乱问题求助

问题本质 #

这是并发子进程的工作目录（cwd）竞态问题：Lerna/Turborepo并发启动多个Jest进程时，Docker容器内的进程调度或文件系统特性，导致部分Jest进程未切换到目标包的目录就执行，从而错误解析了其他包的相对路径参数。本地环境进程调度更稳定，所以不会触发这个问题。

解决方案 #

1. 替换相对路径为绝对路径（核心修复） #

抛弃依赖cwd的../相对路径，改用基于仓库根目录的绝对路径调用Jest。可以通过统一的Node.js脚本封装Jest调用：

步骤1：根目录创建统一执行脚本

// scripts/run-jest.js
const { execSync } = require('child_process');
const path = require('path');
const fs = require('fs');

// 从当前脚本位置推导仓库根目录
const repoRoot = path.resolve(__dirname, '..');
// 读取当前包的package.json，用于生成独立缓存目录
const pkgJson = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8'));

// 定义全局测试资源的绝对路径
const jestConfig = path.join(repoRoot, 'tests/jest.config.json');
const jestSetup = path.join(repoRoot, 'tests/jest-setup.js');
const setEnvVars = path.join(repoRoot, 'tests/setEnvVars.js');

// 收集命令行传入的额外参数（如testPathPattern）
const extraArgs = process.argv.slice(2);

// 构造Jest命令，所有路径均为绝对路径
const jestCmd = [
  'npx jest',
  `--config="${jestConfig}"`,
  `--setupFiles="${jestSetup}"`,
  `--setupFilesAfterEnv="${setEnvVars}"`,
  `--rootDir="${process.cwd()}"`,
  `--cacheDirectory="/tmp/jest-cache-${pkgJson.name}"`, // 每个包用独立缓存目录
  ...extraArgs
].join(' ');

// 执行命令，继承标准输入输出
execSync(jestCmd, { stdio: 'inherit', cwd: process.cwd() });

步骤2：修改所有包的测试脚本

将原来的相对路径调用改为执行统一脚本：

// 某包的package.json
"scripts": {
  "test:integration": "node ../../scripts/run-jest.js --testPathPattern=./integration-tests --runInBand"
}

不管包在目录树的哪个位置，脚本都会自动解析绝对路径，彻底摆脱对cwd的依赖。

2. 根目录统一执行Jest（替代方案） #

放弃让Lerna/Turborepo管理多个Jest进程，直接在仓库根目录用Jest的多项目模式执行测试，由Jest自身处理并发：

根目录package.json添加脚本

"scripts": {
  "test:all": "jest --projects ./packages/* ./cmd/*"
}

每个包添加本地Jest配置

在每个包的目录下创建jest.config.js，继承根目录配置：

// packages/example/jest.config.js
module.exports = {
  rootDir: '.',
  preset: '../../tests/jest.config.json'
};

这种方式只启动一个Jest主进程，避免多进程间的cwd竞态问题。

3. 优化Docker环境配置 #

• 确保容器内的仓库目录是固定绝对路径（如/app），避免挂载时的路径歧义。
• 启动容器时指定工作目录为仓库根：docker run -w /app ...
• 优先使用基于glibc的镜像（如node:bullseye-slim），避免alpine镜像的musl libc可能带来的进程调度差异。

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