VS Code Dev Container中React开发webpack-dev-server内存溢出问题

问题现象 #

开发服务器启动过程中频繁退出，返回错误：

The build failed because the process exited too early. This probably means the system ran out of memory or someone called `kill -9` on the process.

启动阶段伴随webpack弃用警告输出：

根因判断 #

• 上述webpack弃用警告为React Scripts 5.0.1版本的常规依赖提示，不会导致进程崩溃。
• 报错特征完全匹配容器OOM（内存不足）场景：Docker默认内存分配较低时，webpack构建占用内存超过限制，会被系统OOM管理器发送kill -9信号强制终止，和报错描述完全一致。

排查步骤 #

• 进入Dev Container终端执行free -h查看容器总可用内存
• 启动开发服务器时同步执行htop（若未安装可先运行apt update && apt install htop）观察Node进程内存占用，若内存占满瞬间进程退出，即可确认是内存不足问题。

修复方案 #

1. 提升Docker全局内存分配（优先级最高） #

打开Docker Desktop设置面板，进入Resources配置页，将Memory分配值从默认的2GB调整为4GB及以上，保存配置并重启Docker后，重建Dev Container即可。

2. 提升Node进程堆内存上限 #

修改项目package.json中的启动、构建脚本，手动指定Node可用堆内存大小：

"scripts": {
  "start": "NODE_OPTIONS=--max-old-space-size=4096 react-scripts start",
  "build": "NODE_OPTIONS=--max-old-space-size=4096 react-scripts build",
  "test": "react-scripts test",
  "eject": "react-scripts eject"
}

3. 单独配置Dev Container资源限制 #

在devcontainer.json中添加runArgs参数，给当前开发容器单独指定内存配额，避免和其他运行中的容器争抢资源：

{
    "name": "Node.js",
    "build": {
        "dockerfile": "Dockerfile",
        "args": { "VARIANT": "16-bullseye" }
    },
    "runArgs": ["--memory=4g", "--memory-swap=4g"],
    "settings": {},
    "extensions": [
        "dbaeumer.vscode-eslint"
    ],
    "remoteUser": "node"
}

修改配置后需要执行Dev Container: Rebuild Container命令重建容器生效。

附：问题相关原始配置 #

devcontainer.json #

// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
// https://github.com/microsoft/vscode-dev-containers/tree/v0.231.6/containers/javascript-node
{
    "name": "Node.js",
    "build": {
        "dockerfile": "Dockerfile",
        // Update 'VARIANT' to pick a Node version: 16, 14, 12.
        // Append -bullseye or -buster to pin to an OS version.
        // Use -bullseye variants on local arm64/Apple Silicon.
        "args": { "VARIANT": "16-bullseye" }
    },

    // Set *default* container specific settings.json values on container create.
    "settings": {},

    // Add the IDs of extensions you want installed when the container is created.
    "extensions": [
        "dbaeumer.vscode-eslint"
    ],

    // Use 'forwardPorts' to make a list of ports inside the container available locally.
    // "forwardPorts": [],

    // Use 'postCreateCommand' to run commands after the container is created.
    // "postCreateCommand": "yarn install",

    // Comment out to connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.
    "remoteUser": "node"
}

Dockerfile #

# See here for image contents: https://github.com/microsoft/vscode-dev-containers/tree/v0.231.6/containers/javascript-node/.devcontainer/base.Dockerfile

# [Choice] Node.js version (use -bullseye variants on local arm64/Apple Silicon): 16, 14, 12, 16-bullseye, 14-bullseye, 12-bullseye, 16-buster, 14-buster, 12-buster
ARG VARIANT="16-bullseye"
FROM mcr.microsoft.com/vscode/devcontainers/javascript-node:0-${VARIANT}

# [Optional] Uncomment this section to install additional OS packages.
# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive
#     && apt-get -y install --no-install-recommends <your-package-list-here>

# [Optional] Uncomment if you want to install an additional version of node using nvm
# ARG EXTRA_NODE_VERSION=10
# RUN su node -c "source /usr/local/share/nvm/nvm.sh && nvm install ${EXTRA_NODE_VERSION}"

# [Optional] Uncomment if you want to install more global node modules
# RUN su node -c "npm install -g <your-package-list-here>"

package.json #

{
  "name": "some project",
  "version": "0.1.0",
  "private": true,
  "dependencies": {
    "@auth0/auth0-react": "^1.10.1",
    "@testing-library/jest-dom": "^5.16.4",
    "@testing-library/react": "^13.2.0",
    "@testing-library/user-event": "^13.5.0",
    "axios": "^0.27.2",
    "react": "^18.1.0",
    "react-detect-click-outside": "^1.1.7",
    "react-dom": "^18.1.0",
    "react-places-autocomplete": "^7.3.0",
    "react-router-dom": "^6.3.0",
    "react-scripts": "5.0.1",
    "styled-components": "^5.3.5",
    "web-vitals": "^2.1.4"
  },
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject"
  },
  "eslintConfig": {
    "extends": [
      "react-app",
      "react-app/jest"
    ]
  },
  "browserslist": {
    "production": [
      ">0.2%",
      "not dead",
      "not op_mini all"
    ],
    "development": [
      "last 1 chrome version",
      "last 1 firefox version",
      "last 1 safari version"
    ]
  },
  "devDependencies": {
    "prettier": "^2.7.1"
  }
}

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