解决VSCode中Node环境TLS证书校验报错-VSCode-PHP中文网

node.js报self_signed_cert_in_chain错误需从tls层解决：开发阶段可临时设rejectunauthorized: false或node_tls_reject_unauthorized=0；企业环境应导入私有ca证书到node_extra_ca_certs或启用--use-system-ca。

解决vscode中node环境tls证书校验报错

Node.js 进程报 SELF_SIGNED_CERT_IN_CHAIN 怎么办

这不是 VSCode 的设置问题，而是你写的 Node.js 脚本（比如 node index.js）在启动时，TLS 层拒绝了自签名或私有 CA 签发的证书。VSCode 只是宿主环境，真正执行的是独立的 Node.js 进程，它不读取 VSCode 的 http.proxyStrictSSL 设置。

常见触发点：https.request、axios、fetch（底层用 node-fetch 或 undici）、Vite 代理转发到本地 HTTPS 后端、调用公司内网带自签名证书的 API。

错误堆栈里一定含 TLSSocket.onConnectSecure 和 code: 'SELF_SIGNED_CERT_IN_CHAIN'
即使你在 VSCode 设置里关掉 http.proxyStrictSSL，终端里跑 node 仍会报错
VSCode 的 GitHub 登录失败是 Electron 自身网络栈行为，和你的脚本无关

开发阶段临时跳过校验（仅限本地）

最快验证是否为证书问题，但必须明确：这仅用于开发，且只应在可信网络下使用。它不关闭加密，只跳过证书链验证，中间人攻击风险真实存在。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

全局禁用（慎用）：process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0'，必须放在 require('https') 或任何网络模块之前
局部禁用（推荐）：
- 原生 https.request：传 { rejectUnauthorized: false } 到 options
- axios：配置 httpsAgent: new https.Agent({ rejectUnauthorized: false })
- node-fetch@3+：传 { dispatcher: new Agent({ rejectUnauthorized: false }) }
注意：NODE_TLS_REJECT_UNAUTHORIZED=0 是进程级开关，一旦设进 shell 配置（如 ~/.zshrc），所有后续 Node 进程都受影响，包括 npm install、eslint 插件甚至 VSCode 自身的语言服务

企业环境正确导入 CA 证书

公司用了 SSL Inspection 代理？那不是“绕过”，而是把企业根证书加入 Node.js 的信任链。这才是生产就绪的做法。

从 IT 部门拿到根证书（.cer 或 .pem），若为 DER 格式，转成 PEM：openssl x509 -inform DER -in company-ca.cer -out company-ca.pem
合并系统 CA（可选但推荐）：cat /etc/ssl/certs/ca-certificates.crt company-ca.pem > node-ca-bundle.pem（Linux/macOS）
VSCode 终端生效：在 settings.json 中配 "terminal.integrated.env.linux"（或对应平台字段），值为 {"NODE_EXTRA_CA_CERTS": "/path/to/company-ca.pem"}
VSCode 调试必须单独配：launch.json 的 env 字段里显式写入 NODE_EXTRA_CA_CERTS，调试器默认不继承终端环境变量
WSL 用户注意：路径必须是 WSL 内部可读路径（如 /home/user/company-ca.pem），不是 Windows 的 C:\ 路径

别漏掉 NODE_OPTIONS 和 --use-system-ca

Node.js 18.17+ 支持直接启用系统 CA 存储，比手动管理证书文件更轻量，尤其适合桌面开发场景。

启动时加参数：node --use-system-ca index.js
或设环境变量：NODE_OPTIONS=--use-system-ca，同样需确保该变量被 VSCode 终端或 launch.json 正确继承
注意：Windows 上它读取系统证书存储（Local Machine\Root），macOS 读取 system roots，Linux 通常无效（依赖发行版是否打包了 ca-certificates）
与 NODE_EXTRA_CA_CERTS 可叠加使用，Node.js 会合并所有来源的 CA

最常被忽略的是调试时证书没加载——终端里 npm start 成功，但断点调试失败，往往因为 launch.json 没同步证书路径或 NODE_OPTIONS，而不是证书本身有问题。