Webpack构建NodeJS TS项目时JavaScript内存堆错误优化求助

算力阿峰

2026-8-5

NodeJS+TypeScript项目Webpack构建内存溢出问题求助

我有一个基于NodeJS+TypeScript的项目，使用Webpack 5构建。编译时终端出现JavaScript内存堆溢出错误，本地可通过提升内存限制生成构建产物，但服务器存在内存限制无法操作。希望通过并行构建或内存优化技巧解决问题，以下是我的配置，求指出当前配置的问题或可优化点。

package.json依赖

"devDependencies": {
        "fs": "^0.0.1-security",
        "glob": "^8.0.3",
        "path": "^0.12.7",
        "ts-loader": "^9.4.1",
        "ts-node": "^10.9.1",
        "typescript": "^4.9.3",
        "webpack": "^5.75.0",
        "webpack-cli": "^5.0.0",
        "zip-webpack-plugin": "^4.0.1"
    },
    "dependencies": {
        "@types/aws-lambda": "^8.10.109",
        "@types/tedious": "^4.0.9",
        "aws-sdk": "^2.1257.0",
        "axios": "^1.2.0",
        "jsonwebtoken": "^8.5.1",
        "node-tls": "^0.10.2",
        "sequelize": "^6.28.0",
        "tedious": "^15.1.2"
    }

webpack.config.js配置

const webpack = require('webpack');
const path = require("path");
const glob = require("glob");
const ZipPlugin = require("zip-webpack-plugin");
const tedious = require("tedious");
const TerserPlugin = require('terser-webpack-plugin');

const entries = () => {
  const src = path.resolve(__dirname, "functions");
  const files = glob.sync(src + "/**/*");
  return files
    .filter((f) => f.indexOf("index.ts") > -1)
    .map((f) => "./" + path.relative(path.resolve(__dirname), f));
};

const getBundleName = (path) =>
  path
    .substring("./functions/".length, path.lastIndexOf("/"))
    .replaceAll("/", "-")
    .toLowerCase();

const config = () => {
  let modules = [];
  const files = entries();
  files.forEach((f) => {
    console.log(f)
    const bundleName = getBundleName(f);

    const outputPath = path.resolve(
      __dirname,
      "dist/" +
        bundleName.substring(0, bundleName.lastIndexOf("-")) +
        "/" +
        bundleName.substring(bundleName.lastIndexOf("-") + 1)
    );

    const moduleConfig = {
      name: bundleName,
      entry: f,
      output: {
        path: outputPath,
        filename: "index.js",
        libraryTarget: "commonjs",
        clean: true,
      },
      module: {
        rules: [
          {
            test: /\.ts?$/,
            use: "ts-loader",
            exclude: [/node_modules/, /\.test.ts?$/],
          },
        ],
      },
      target: "node",
      plugins: [
        new ZipPlugin({
          path: "./",
          filename: `${bundleName}.zip`,
        }),
        new webpack.ids.DeterministicChunkIdsPlugin({
          maxLength: 5,
        }),
      ],
      optimization: {
        minimizer: [
          new TerserPlugin({
            parallel: true,           
          }),
        ],
        chunkIds: 'named',
        concatenateModules: true,
        emitOnErrors: true,
        mangleWasmImports: true,
        moduleIds: 'deterministic',
        runtimeChunk: {
          name: 'runtime',
        },
        sideEffects: 'flag',
        usedExports: 'global',
      },
      resolve: {
        mainFields: ["main"],
        extensions: [".tsx", ".ts", ".js", ".json", "..."],
        alias: {'tedious': path.join(__dirname, './node_modules/tedious')},
      },
      resolveLoader: {
        modules: ["node_modules"],
      },
      externals: ['pg', 'sqlite3', 'tedious', 'pg-hstore'],
      /*devtool: "source-map",*/
    };

    modules.push(moduleConfig);
  });

  return modules;
};

module.exports = config();

优化方案与问题分析

当前配置的核心问题

多配置实例并行内存过载：每个函数对应一个独立Webpack配置实例，默认并行处理+Terser并行压缩会瞬间占用大量内存，直接触发溢出。
冗余优化配置：
- runtimeChunk: 'runtime'：Node.js CommonJS场景下完全没必要，额外增加编译开销与内存占用。
- concatenateModules: true：单入口函数场景下模块合并无意义，反而增加内存消耗。
- emitOnErrors: true：错误时仍输出产物，掩盖问题且不影响内存，建议关闭。
ts-loader无缓存：每次构建重复编译所有TS文件，浪费内存与时间。
低效文件匹配：遍历所有文件再过滤index.ts，不如直接精准匹配。
无用依赖引入：配置中直接require("tedious")，但已将其设为externals，启动时加载纯粹占用内存。

内存优化与并行调整技巧

1. 限制并行并发数

用webpack-cli参数控制配置实例并行数：
```
webpack --max-parallel 2
```

调整Terser并行数，避免占满CPU核心：

new TerserPlugin({
  parallel: Math.max(1, require('os').cpus().length - 1), // 留1核给系统
  terserOptions: {
    compress: { drop_console: true } // 移除console，减小产物同时降低压缩内存占用
  }
})

2. 清理冗余优化配置

修改optimization部分：

optimization: {
  minimizer: [
    new TerserPlugin({
      parallel: Math.max(1, require('os').cpus().length - 1),
      terserOptions: { compress: { drop_console: true } }
    }),
  ],
  chunkIds: 'deterministic', // 保留保证产物稳定
  moduleIds: 'deterministic',
  sideEffects: true, // 设为true更高效，需在package.json正确标记sideEffects
  usedExports: true, // 精准树摇未使用代码，替代'global'
  // 移除runtimeChunk、concatenateModules、emitOnErrors、mangleWasmImports
}

3. 启用ts-loader缓存

修改loader配置，减少重复编译：

module: {
  rules: [
    {
      test: /\.ts?$/,
      use: {
        loader: "ts-loader",
        options: {
          transpileOnly: true, // 仅转译，类型检查单独用`tsc --noEmit`执行
          happyPackMode: true, // 配合transpileOnly提升速度、降低内存
          compilerOptions: { module: "esnext" }, // 利于Webpack树摇
          cacheDirectory: true // 启用硬盘缓存
        }
      },
      exclude: [/node_modules/, /\.test.ts?$/],
    },
  ],
},

4. 优化入口匹配逻辑

直接精准匹配index.ts，减少文件遍历：

const entries = () => {
  const src = path.resolve(__dirname, "functions");
  return glob.sync(src + "/**/index.ts").map((f) => "./" + path.relative(path.resolve(__dirname), f));
};

5. 移除无用依赖引入

删除配置中的const tedious = require("tedious");，避免启动时加载冗余模块。

6. 拆分构建任务

若函数数量多，按目录分组分批构建：

// 按一级目录分组
const entries = (group) => {
  const src = path.resolve(__dirname, `functions/${group}`);
  return glob.sync(src + "/**/index.ts").map((f) => "./" + path.relative(path.resolve(__dirname), f));
};

// 根据环境变量生成对应配置
const config = (env) => {
  let modules = [];
  const files = entries(env.group);
  // ... 后续逻辑不变
};

module.exports = (env) => config(env);

在package.json添加分组构建脚本：

"scripts": {
  "build:group1": "webpack --env group=group1",
  "build:group2": "webpack --env group=group2",
  "build": "npm run build:group1 && npm run build:group2"
}

7. 替换为swc-loader（可选）

用Rust实现的swc-loader替代ts-loader，编译更快、内存占用更低：

安装依赖：

npm install --save-dev swc-loader @swc/core

修改loader配置：

module: {
  rules: [
    {
      test: /\.ts?$/,
      use: {
        loader: "swc-loader",
        options: {
          jsc: {
            parser: { syntax: "typescript" },
            target: "es2020"
          },
          cacheDirectory: true
        }
      },
      exclude: [/node_modules/, /\.test.ts?$/],
    },
  ],
},

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

Webpack构建NodeJS TS项目时JavaScript内存堆错误优化求助

package.json依赖 #

webpack.config.js配置 #

当前配置的核心问题 #

内存优化与并行调整技巧 #

1. 限制并行并发数 #

2. 清理冗余优化配置 #

3. 启用ts-loader缓存 #

4. 优化入口匹配逻辑 #

5. 移除无用依赖引入 #

6. 拆分构建任务 #

7. 替换为swc-loader（可选） #