前端知识

[TOC]

node环境常见问题

1. node告警：Maxlistenersexceededwarning

告警的意思是对一个事件添加了11个监听器，溢出了监听器的最大值，需要通过setMaxListeners()增加监听器限制最大值。

增加监听器的limit数量，甚至取消限制，可以解决问题（后文会展示解除限制的方法）。 但这种情况根本的解决途径是去排查什么地方对一个事件增加了11个监听器，当确定11个监听器都是有必要的时候再去增加监听器的限制数。

在vue.config.js文件中添加如下代码：

require('events').EventEmitter.defaultMaxListeners = 20; // 将MaxListeners的限制数增加到20
require('events').EventEmitter.defaultMaxListeners = 0; // 解除限制

参考：https://segmentfault.com/a/1190000040710342

2. node 内存不足：JavaScript heap out of memory

在vue2项目使用webpack打包报错

<--- JS stacktrace --->

FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory
 1: 00007FF7E1BA3D05
 2: 00007FF7E1B7DD46
 3: 00007FF7E1B7E610

在vue3项目使用vite报如下错误：

2.1 错误原因

是由于 Node.js 进程的内存不足导致的 JavaScript 堆内存溢出。这种问题常见于处理大型项目或复杂依赖时，Node.js 默认的内存限制（通常为 2GB）不足以支持打包过程。

2.1.1 查看node运行内存大小命令

node -e "console.log('node内存上限:', v8.getHeapStatistics().heap_size_limit / 1024 / 1024 + 'MB')"

2.2 解决方法

注意：修改的内存单位是MB。

2.2.1 通过环境变量全局设置（推荐）

通过环境变量 NODE_OPTIONS 设置 Node.js 的默认内存限制，适用于所有通过命令行启动的 Node.js 进程。

配置完成后可以使用查看node运行内存命令查看是否修改成功。

1、Linux/macOS

在用户配置文件（如 ~/.bashrc、~/.zshrc）中添加以下内容：

# 设置 Node.js 堆内存上限为 4GB（根据需求调整）
export NODE_OPTIONS=--max-old-space-size=4096

保存后执行以下命令使配置生效：

source ~/.bashrc  # 或 source ~/.zshrc（取决于你的终端）

2、Windows

通过系统环境变量配置：

  1. 右键点击“此电脑” → “属性” → “高级系统设置” → “环境变量”。
  2. 在“用户变量”或“系统变量”中，点击“新建”：
    • 变量名：NODE_OPTIONS
    • 变量值：--max-old-space-size=4096
  3. 重启所有命令行工具（如 CMD、PowerShell）使配置生效。

2.2.2 修改npm命令脚本

在 package.json 的脚本命令中添加 --max-old-space-size 参数显式提高 Node.js 的堆内存上限。

{
  "scripts": {
    "": "对于vue2 webpack打包工具，使用如下命令：",
    "build": "node --max_old_space_size=4096 node_modules/@vue/cli-service/bin/vue-cli-service.js build",
    
    "": "对于vue3 vite打包工具，使用如下命令：",
    "start": "node --max-old-space-size=4096 src/index.js",
    "build": "node --max-old-space-size=4096 ./node_modules/vite/bin/vite.js build"
  }
}

之后运行 npm run build 或 npm start 时，会自动应用内存限制。

2.2.3 使用increase-memory-limit工具修改

# 全局安装increase-memory-limit
npm install -g increase-memory-limit
# 进入工程目录，执行：
increase-memory-limit

# 备用选项：https://www.pudn.com/news/62c43ba1502ed3121a92d0bb.html
npm i -g cross-env
#安装结束后，运行如下命令：
cross-env LIMIT=10240  increase-memory-limit # LIMIT是分配的内存大小，有3027、4096、8192、10240

在windows系统中，当运行increase-memory-limit命令提示报错，node --max-old-space-size=4096不是内部或外部命令

这个问题，是因为执行 fix-memory-limit命令时，会在 当前项目的node_modules/.bin文件夹下的*.cmd文件中添加调整运行空间的命令，默认添加的"%_prog%"，但是项目的正常运行需要%_prog%,也就是去掉双引号才可以。

可以通过编辑器的 replace all的功能，全局进行替换，注意不要选错目录。由此目录也可以发现，当前的命令是只针对当前项目的，所以，如果新开了一个项目，或者删除了node_modules依赖后，需要重新执行命令才可以。 如果vscode全局搜索搜不到 "%_prog%"关键字，需要点一下下面按钮：

参考链接：https://blog.csdn.net/Run_youngman/article/details/122474730

注意：increase-memory-limit命令可能会导致git提交命令冲突，解决方法是删除node_modules文件夹，重新安装一个就好。

2.3 注意事项

  1. 合理设置内存大小：

    • 建议值为物理内存的 50%~80%（如 8GB 物理内存可设置为 4096）。
    • 设置过高可能导致系统卡顿甚至崩溃。

  2. 场景优先级：

    • 开发环境：推荐使用方法一（环境变量）或方法二（npm 脚本）。
    • 生产环境：在启动命令中显式指定参数（如 node --max-old-space-size=4096 server.js）。

  3. 容器化部署（如 Docker）：

    • 在 Dockerfile 中通过环境变量设置：

      ENV NODE_OPTIONS=--max-old-space-size=4096

  4. 为什么默认内存限制是 2GB？

    Node.js（基于 V8 引擎）默认堆内存上限为约 2GB（64 位系统），这是为了平衡性能和稳定性。对于内存密集型任务（如构建工具、大数据处理），需手动调整此限制。

3. 监听文件数量超限 ENOSPC：system limit for number of file watchers reached

当我在 统信桌面操作系统(UOS)的类Linux系统启动node服务的时候，报错。

3.1 错误信息

node:internal/errors:490 errorCaptureStackTrace(err) Error：ENOSPC：system limit for number of file watchers reached

3.2 错误原因

ENOSPC: system limit for number of file watchers reached 是 Linux/Unix 系统中常见的文件监视器（inotify）数量超限问题。该错误通常发生在使用 Node.js 工具（如 Webpack、Nodemon、Vite 等）或文件监控类程序时，系统默认的文件监视器数量不足以支持当前应用的需求。

  • 文件监视器（inotify）：Linux 系统通过 inotify 机制监控文件变化（如文件修改、新增、删除）。每个文件/目录的监控会占用一个“监视器”。
  • 默认限制过低：Linux 系统默认的 max_user_watches（单个用户可用的最大监视器数量）通常为 8192，对于大型项目或频繁文件操作的应用（如前端开发工具），此限制容易被触发。

查看默认数量命令：cat /proc/sys/fs/inotify/max_user_watches

3.3 解决方案

  • 永久调整限制(推荐)

    # 编辑 sysctl 配置文件
sudo vi /etc/sysctl.conf

# 在文件末尾添加以下行（示例值为 524288）
fs.inotify.max_user_watches=524288

# 保存退出后，执行以下命令使配置生效
sudo sysctl -p

  • 临时调整限制(重启电脑后失效)

    # 将限制提升到 524288（根据需求调整数值）
sudo sysctl fs.inotify.max_user_watches=524288

  • 针对特定工具优化

    • Webpack：在 watchOptions 中忽略 node_modules 等无需监控的目录：

      // webpack.config.js
module.exports = {
  watchOptions: {
    ignored: /node_modules/
  }
};

    • Vite：在 vite.config.js 中使用 server.watch.ignored 选项。

      import { defineConfig } from 'vite';
export default defineConfig({
  server: {
    watch: {
      ignored: ['**/node_modules', '**/dist']
    }
  }
});

    • Nodemon：在 nodemon.json 中配置忽略目录：

      {
  "ignore": ["node_modules/**"]
}

3.4 扩展知识

  • fs.inotify 参数：
    • max_user_watches：单个用户可监视的文件/目录数量。
    • max_user_instances：单个用户可创建的监视器实例数量。
    • max_queued_events：事件队列的最大长度。
  • 其他系统：
    • macOS：无此问题（使用不同的文件监控机制）。
    • Windows：通过 WSL 运行时需在 Linux 子系统中调整。
Edit this page
Last Updated: 3/19/2025, 11:02:54 AM