如何在Node.js中正确设置NODE_EXTRA_CA_CERTS环境变量

1. 按场景选择适配的配置方式 #

临时生效（仅对当前终端/单次启动有效） #

• Windows cmd环境：set NODE_EXTRA_CA_CERTS=C:\完整\路径\to\ca.pem && node 你的启动文件.js
• Windows PowerShell环境：$env:NODE_EXTRA_CA_CERTS="C:\完整\路径\to\ca.pem"; node 你的启动文件.js
• Linux/macOS环境：NODE_EXTRA_CA_CERTS=/完整/路径/to/ca.pem node 你的启动文件.js

永久生效（对所有终端/项目生效） #

• Windows系统：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，新建用户变量或系统变量，变量名填NODE_EXTRA_CA_CERTS，变量值填证书的完整绝对路径，配置完成后重启所有终端窗口生效。
• Linux/macOS系统：将export NODE_EXTRA_CA_CERTS=/完整/路径/to/ca.pem写入当前用户的shell配置文件（~/.bashrc/~/.zshrc等，对应你使用的终端类型），保存后执行source ~/.bashrc（对应你修改的配置文件名）生效；如果需要全局对所有用户生效，将上述命令写入/etc/profile文件后source生效。

2. 常见不生效问题排查 #

• 必须使用绝对路径，不要使用相对路径、占位符、路径缩写（比如~），部分Node版本无法识别非标准化的路径写法。
• 配置完成后必须重启启动Node进程的终端，再重新启动项目，旧的终端窗口不会读取新的环境变量配置。
• 可以在项目代码中添加打印语句验证变量是否加载成功：console.log(process.env.NODE_EXTRA_CA_CERTS)，如果输出为undefined说明环境变量未正确注入当前进程的运行环境。
• 确认证书文件本身是标准PEM格式，且运行Node进程的用户对证书文件有可读权限。
• 如果使用pm2等进程管理工具启动项目，需要重启进程管理工具的守护进程后再重启项目，否则旧的进程缓存会继续使用旧的环境变量。

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