WebdriverIO v8测试在Chrome中运行时内存不足错误的解决方法咨询

我之前在升级Node.js到20版本、把WebdriverIO v8的测试脚本从CommonJS切换到ESM模块系统时，碰到过完全一样的Chrome内存溢出问题——当时也加了和你类似的参数，但还是频繁触发OOM错误，折腾了好一阵才整理出几个亲测有效的解决方向，分享给你：

先修正一个关键拼写错误！ #

首先要提醒你：你现有chromeOptions.args里的--disable-dev-shm-usuage有拼写错误，正确的是--disable-dev-shm-usage，这个错误会导致该内存优化参数完全不生效，这大概率是你当前问题的主要诱因之一！

Chrome启动参数补充优化 #

修正拼写后，再补充几个针对性的内存控制参数：

• 强制Chrome使用指定的JS堆内存上限：添加--js-flags="--max-old-space-size=4096"（数值可根据机器内存调整，8G内存的话建议设为6144）
• 禁用不必要的后台资源消耗：添加--disable-background-timer-throttling、--disable-background-networking、--disable-extensions，这些后台进程/扩展会悄悄占用大量内存
• 测试环境禁用沙箱机制：添加--no-sandbox，沙箱在资源紧张的环境下会额外消耗内存（仅建议测试环境使用，生产环境勿用）

调整后的完整chromeOptions示例：

chromeOptions: {
  args: [
    '--disable-gpu',
    '--disable-dev-shm-usage', // 已修正拼写
    '--js-flags="--max-old-space-size=4096"',
    '--disable-background-timer-throttling',
    '--disable-background-networking',
    '--disable-extensions',
    '--no-sandbox'
  ]
}

WebdriverIO配置与测试代码优化 #

• 降低并发测试实例数：在wdio.conf.js里把maxInstances从默认的5调整为2-3。Node.js 20的V8引擎内存模型和16差异较大，ESM模块加载的额外开销会让并发实例的内存占用陡增，减少并发能直接缓解内存压力
• 强制测试后清理资源：在afterTest钩子中添加页面销毁逻辑，避免DOM节点或全局引用内存泄漏：

afterTest: async function(test, context, { error, result, duration, passed, retries }) {
  if (typeof browser !== 'undefined') {
    await browser.execute(() => {
      // 清理页面全局监听与自定义变量
      window.addEventListener = () => {};
      window.removeEventListener = () => {};
      for (const key in window) {
        if (key.startsWith('test_')) delete window[key];
      }
    });
    await browser.deleteSession();
  }
}

• 优化ESM模块引用：避免全局导入大体积模块，尽量在测试用例内部使用动态import()，减少模块缓存的内存占用；同时排查是否存在循环引用的模块，这在ESM下更容易引发内存泄漏

Node.js进程层面优化 #

• 给Node.js进程设置更大的内存上限：启动WebdriverIO时添加Node的内存参数，比如：
  node --max-old-space-size=8192 ./node_modules/.bin/wdio run wdio.conf.js
• 调试时可禁用ESM缓存：添加--no-cache参数，避免模块缓存累积占用内存，但注意这会减慢测试启动速度，仅建议调试泄漏问题时使用

环境层面优化（针对CI/容器环境） #

• 确保临时目录有足够空间：虽然--disable-dev-shm-usage会让Chrome fallback到临时文件，但有些CI环境的/tmp目录空间有限，可以手动挂载更大的临时卷
• 指定临时Chrome用户数据目录：在chromeOptions中生成临时的userDataDir，每个测试会话后自动删除，避免旧缓存数据累积：

const os = require('os');
const path = require('path');
const tmpDir = path.join(os.tmpdir(), `chrome-test-${Date.now()}`);

chromeOptions: {
  args: [...],
  userDataDir: tmpDir
}

• 在CI配置中增加SHM大小：比如GitHub Actions中可以在job里添加options: --shm-size=2g，GitLab CI中设置SHM_SIZE: 2g

内存泄漏排查方法 #

如果以上方法都没解决，建议定位具体泄漏点：

• 用Chrome DevTools附加到测试Chrome实例：打开chrome://inspect，找到测试用的Chrome进程，打开Memory面板做堆快照，查看未释放的DOM节点或全局变量
• 调试Node.js进程：启动WebdriverIO时添加--inspect参数，用Chrome DevTools调试Node进程，查看内存占用趋势，定位泄漏的模块或测试用例

我当时先修正了参数拼写，再把maxInstances调到2，就解决了80%的内存问题，剩下的是清理了几个循环引用的ESM模块才彻底搞定。

内容来源于stack exchange