使用Vite+ReactJS时如何设置NODE_OPTIONS扩大HTTP请求头大小？

问题核心 #

提交超长字符串触发431错误，需增大Node.js的max-http-header-size参数，但之前的配置把Node环境变量当成了Vite命令参数，导致无效。

正确配置方案 #

方案1：直接修改package.json（区分系统）

• Linux/macOS：将NODE_OPTIONS放在vite命令前，修改scripts中的dev项：

"scripts": {
  "dev": "NODE_OPTIONS=--max-http-header-size=128000 vite",
  "build": "vite build",
  "lint": "eslint . --ext js,jsx --report-unused-disable-directives --max-warnings 0",
  "preview": "vite preview"
}

• Windows（CMD）：需用set命令先设置环境变量再启动Vite：

"scripts": {
  "dev": "set NODE_OPTIONS=--max-http-header-size=128000 && vite",
  "build": "vite build",
  "lint": "eslint . --ext js,jsx --report-unused-disable-directives --max-warnings 0",
  "preview": "vite preview"
}

方案2：跨平台兼容（推荐）

用cross-env包统一跨平台环境变量设置：

1. 安装依赖：

npm install cross-env --save-dev

2. 修改package.json的scripts：

"scripts": {
  "dev": "cross-env NODE_OPTIONS=--max-http-header-size=128000 vite",
  "build": "vite build",
  "lint": "eslint . --ext js,jsx --report-unused-disable-directives --max-warnings 0",
  "preview": "vite preview"
}

方案3：临时终端启动（无需修改配置）

• Linux/macOS：

NODE_OPTIONS=--max-http-header-size=128000 npm run dev

• Windows（CMD）：

set NODE_OPTIONS=--max-http-header-size=128000 && npm run dev

• Windows（PowerShell）：

$env:NODE_OPTIONS="--max-http-header-size=128000"; npm run dev

关键说明 #

NODE_OPTIONS是Node.js的环境变量，必须放在Vite命令前才能被Node进程读取生效，之前的错误是将其作为Vite参数传递，导致Node无法识别。

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