解决VSCode中Node连接HTTPS接口由于自签名证书链报错的问题

云静大大_5786

云静大大_5786

2026-07-02

428人浏览

原创

根本原因是node.js tls层拒绝自签名证书,需在node.js层解决:临时禁用校验(开发用rejectunauthorized: false)或导入证书到ca列表(node_extra_ca_certs),vite/webpack代理需设secure: false。

解决vscode中node连接https接口由于自签名证书链报错的问题

VSCode 里 Node.js 脚本调用 HTTPS 接口失败,报 SELF_SIGNED_CERT_IN_CHAIN,根本原因不是 VSCode 本身,而是它启动的 Node.js 进程继承了系统或网络环境中的证书策略 —— 解决必须从 Node.js 层下手,而不是只改 VSCode 设置。

Node.js 脚本运行时遇到 SELF_SIGNED_CERT_IN_CHAIN 错误

这个错误来自 Node.js 的 TLS 层,说明你代码里用 https.request、axios、fetch(底层是 node-fetch 或 undici)等发起 HTTPS 请求时,目标服务用了自签名证书,而 Node.js 默认拒绝这种证书链。

常见触发场景:本地开发后端启用了 HTTPS(如 Express + 自签名 cert)、调用公司内网 API、Vite/webpack dev server 代理到带自签名证书的测试环境。

  • 错误堆栈里一定包含 TLSSocket.onConnectSecure 和 code: 'SELF_SIGNED_CERT_IN_CHAIN'
  • VSCode 的「GitHub 登录失败」是同类问题,但那是 VSCode 自身 Electron 环境的 HTTP 客户端行为;你写的 Node.js 脚本是独立进程,不受 http.proxyStrictSSL 控制
  • 即使你在 VSCode 里关掉了 http.proxyStrictSSL,运行 node index.js 仍会报错

在脚本中临时禁用证书校验(仅限开发)

最直接的办法是在代码开头加一行环境变量设置,或在请求选项里显式关闭校验。这是最快验证是否为证书问题的手段。

Rydberg Agent Node
Rydberg Agent Node

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

下载
  • 全局禁用(不推荐长期使用):process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';,放在 require 任何网络模块之前
  • 局部禁用(推荐):如果用原生 https 模块,给 options 加 rejectUnauthorized: false
  • 如果用 axios,配置 httpsAgent:new https.Agent({ rejectUnauthorized: false })
  • 如果用 node-fetch(v3+),传 { dispatcher: new Agent({ rejectUnauthorized: false }) }

注意:rejectUnauthorized: false 不等于跳过全部 TLS,它只跳过证书链验证,加密通道依然建立,但无法防御中间人攻击 —— 切勿用于生产环境或处理敏感数据。

让 Node.js 信任你的自签名证书(安全且可复现)

比全局关校验更稳妥的做法,是把自签名证书加入 Node.js 的可信 CA 列表。这需要两步:拿到证书文件(.crt 或 .pem),然后告诉 Node.js 去读它。

  • 用 NODE_EXTRA_CA_CERTS 环境变量(推荐):NODE_EXTRA_CA_CERTS="/path/to/cert.crt" node index.js
  • 在脚本里读取并注入(适合打包或统一配置):ca: fs.readFileSync('/path/to/cert.crt') 传给 https.request 或 https.Agent
  • 确认证书内容正确:用 openssl x509 -in cert.crt -text -noout 看是否包含 Subject: 和有效日期,避免复制了私钥或格式错乱
  • Windows 用户注意路径分隔符,用正斜杠 / 或双反斜杠 \,单反斜杠会触发转义问题

Vite / Webpack Dev Server 代理转发时的证书问题

如果你的前端项目用 Vite 启动 dev server,再通过 proxy 转发请求到后端 HTTPS 服务,报错通常出现在代理层,而非你的业务代码。

  • Vite 配置里必须设 secure: false(不是 strictSSL: false):server.proxy['/api'] = { target: 'https://localhost:8080', secure: false }
  • Webpack DevServer 对应字段是 secure: false,同样不能写成 rejectUnauthorized: false
  • 这个 secure: false 是指「允许代理连接到不安全的 HTTPS 目标」,和 Node.js 的 rejectUnauthorized 语义一致,但配置位置不同
  • 如果代理目标是 https://127.0.0.1 而不是 https://localhost,某些证书可能因 SAN(Subject Alternative Name)不匹配被拒,需重新生成含 IP 的证书

真正容易被忽略的是:VSCode 的终端、调试器(Run and Debug)、Tasks 三者启动 Node.js 进程的方式不同,环境变量继承行为也不一致 —— 比如通过 launch.json 启动调试时,env 字段要手动加 NODE_TLS_REJECT_UNAUTHORIZED,否则照样报错。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode node.js node

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3068

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

4469

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3709

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

406

15

vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1215

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2532

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1869

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1707

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2567

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程