NextJS服务端开发：企业代理下如何无代码修改实现请求代理？

问题背景 #

Mac OS X 环境下使用 NextJS 13.4.19 + Yarn v1 开发服务端API，开发机处于企业代理网络中，服务端出站请求被防火墙拦截，需在不修改业务代码的前提下解决代理转发问题。

可行解决方案 #

方案1：修正 global-agent 配置与启动命令 #

之前的启动命令存在参数格式问题，调整后可生效：

1. 安装项目依赖：

   yarn add global-agent
   

2. 在项目 .env 文件中添加代理配置：

   GLOBAL_AGENT_HTTP_PROXY=http://你的代理地址:端口
   GLOBAL_AGENT_HTTPS_PROXY=http://你的代理地址:端口
   GLOBAL_AGENT_NO_PROXY=localhost,127.0.0.1
   

3. 使用正确的启动命令（注意半角破折号，禁用实验性fetch）：

   node -r global-agent/bootstrap --no-experimental-fetch node_modules/next/dist/bin/next dev
   

   说明：NextJS 13.4+ 默认启用实验性fetch，会绕过 global-agent 的拦截，必须禁用；无需额外引入 cross-fetch polyfill，禁用实验性fetch后 Node 会使用传统 http/https 模块，可被 global-agent 代理。

方案2：通过 NODE_OPTIONS 简化启动流程 #

将代理配置注入环境变量，无需每次启动手动加参数：

1. 在 .env.local 或 .env 中添加：

   NODE_OPTIONS="-r global-agent/bootstrap --no-experimental-fetch"
   GLOBAL_AGENT_HTTP_PROXY=http://你的代理地址:端口
   GLOBAL_AGENT_HTTPS_PROXY=http://你的代理地址:端口
   GLOBAL_AGENT_NO_PROXY=localhost,127.0.0.1
   

2. 直接用常规命令启动：

   yarn dev
   

方案3：使用 proxy-agent 替代 global-agent #

如果 global-agent 仍不生效，可尝试更底层的代理拦截：

1. 安装依赖：

   yarn add proxy-agent
   

2. 在项目根目录创建 proxy-boot.js 文件：

   const { ProxyAgent } = require('proxy-agent');
   const http = require('http');
   const https = require('https');
   
   const proxyUrl = process.env.HTTP_PROXY || process.env.http_proxy;
   if (proxyUrl) {
     const agent = new ProxyAgent(proxyUrl);
     http.globalAgent = agent;
     https.globalAgent = agent;
   }
   

3. 在 .env 中配置：

   NODE_OPTIONS="-r ./proxy-boot.js --no-experimental-fetch"
   HTTP_PROXY=http://你的代理地址:端口
   HTTPS_PROXY=http://你的代理地址:端口
   

4. 启动项目：

   yarn dev
   

注意事项 #

• 代理地址需使用 http 协议（即使转发 https 请求，代理服务本身通常为 http），格式如 http://proxy.company.com:8080
• 若代理需要认证，地址格式为 http://用户名:密码@代理地址:端口
• 确保服务端代码未手动设置请求 agent，否则会绕过全局代理配置
• Mac 终端中手动设置的环境变量需确保 Yarn 能读取到，优先使用项目 .env 文件管理配置

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