Node.js配置SSL/HTTPS遇unable to verify the first certificate报错
问题场景
在Node.js环境搭建自托管HTTPS服务过程中,编写的服务启动代码如下(注:代码首行enconst为输入笔误,实际应为const):
const https = require("https"); const app = require("./app"); var fs = require("fs"); var options = { hostname: "sharkfood-portal.de", key: fs.readFileSync("/opt/certs/_.sharkfood-portal.de_private_key.key"), cert: fs.readFileSync( "/opt/certs/_.sharkfood-portal.de_ssl_certificate_INTERMEDIATE.cer" ), requestCert: false, rejectUnauthorized: false, }; const port = process.env.PORT || 12103; const server = https.createServer(options, app); server.listen(port);
启动报错信息
运行上述代码启动服务时,控制台抛出如下错误:
Error: unable to verify the first certificate at TLSSocket.onConnectSecure (_tls_wrap.js:1502:34)
该报错的中文含义为:无法验证第一级证书。
错误根源与修复方案
触发原因
该报错本质为服务端配置的证书链不完整:当前options.cert字段仅加载了单张中间证书文件,既没有包含域名对应的实体证书,也没有按顺序拼接从域名端证书到受信任根证书的完整链路,导致Node.js在本地校验加载的证书合法性时,无法追溯到受信任的根证书节点,触发校验失败。
需要特别说明:代码中配置的rejectUnauthorized: false仅作用于服务端校验客户端证书的流程,不会跳过Node.js自身加载证书时的本地合法性校验,因此该配置无法屏蔽当前报错。
具体修复操作
- 优先替换证书加载路径为证书颁发机构提供的完整链文件:通常CA提供的证书压缩包中会包含名为
fullchain.cer的合并文件,内部已经按「域名实体证书 -> 各级中间证书 -> 根证书」的顺序拼接完成所有内容,直接将该文件路径传入options.cert即可。 - 无现成完整链文件时,可手动拼接证书内容生成合规的pem文件:将域名自身的实体证书内容放在文件最开头,后续按证书颁发层级依次拼接所有上级中间证书的pem内容,不得颠倒证书顺序,否则会触发同类校验错误。
- 排查校验阶段可通过OpenSSL命令确认证书内容完整性:执行
openssl x509 -in 你的证书文件路径 -noout -issuer -subject,确认当前加载的证书主体、颁发者信息匹配对应的证书层级要求。
内容的提问来源于stack exchange,提问作者ironHide214
相关产品推荐
相关产品推荐

