React项目Jest单元测试无法在Azure DevOps Pipeline执行问题排查

1. 运行模式不匹配 #

本地执行npm run test时，Jest默认是交互式模式，会等待用户输入选择操作，但流水线是无人值守环境，必须强制非交互式运行。

• 检查package.json的test命令，确保加上--ci和--watchAll=false参数，比如：

  "scripts": {
    "test": "react-scripts test --ci --watchAll=false"
  }
  

  没加这两个参数的话，Jest会一直卡在等待输入的状态，最终导致流水线超时。

2. 资源与环境差异 #

Azure DevOps的代理机器资源（CPU、内存）通常比本地开发机弱，一些在本地跑很快的测试，到流水线里可能因为资源不足卡住：

• 试试给Jest指定并发数，比如--maxWorkers=2（根据代理配置调整，别设太高导致资源耗尽）
• 本地执行jest --no-cache，模拟流水线的干净环境，看是否会出现卡住的情况——本地可能靠缓存跳过了有问题的用例
• 检查测试依赖的环境，比如jsdom是否正确初始化，必要时在Jest配置里显式指定--env=jsdom

3. 日志输出被屏蔽 #

流水线里Jest可能默认静默输出，导致你看不到测试进度，误以为完全没运行：

• 给test命令加--verbose参数，强制输出每个测试用例的执行日志，方便定位卡住的环节
• 加--logHeapUsage参数，查看内存使用情况，排查是否有内存泄漏导致测试挂起

4. 测试用例本身有问题 #

某些测试用例在本地能跑过，但在流水线环境下会卡住：

• 排查异步测试是否有遗漏的done回调，或者async/await没正确处理——这类问题会让测试一直等待完成信号
• 逐个运行测试文件，在流水线里单独执行某几个文件，定位到具体卡住的用例，再针对性修复

5. 流水线配置问题 #

• 确认流水线步骤的工作目录是项目根目录，别在错误的路径下执行npm run test
• 用npm ci代替npm install安装依赖，确保依赖版本和本地完全一致，避免依赖差异引发的问题
• 如果用的是自托管代理，检查代理机器是否有其他进程占用大量资源，或者权限问题导致Jest无法正常运行

内容的提问来源于stack exchange，提问作者R.A 1