猫头虎带你解决：error Error: certificate has expired

猫头虎-前端技术

于 2024-09-27 18:47:09 发布

阅读量639

点赞数 7

分类专栏：已解决Bug专栏文章标签： bug json 前端 angular.js https 正则表达式 angular

公众号：猫头虎技术团队

本文链接：https://blog.csdn.net/libin9iOak/article/details/142600239

版权

已解决Bug专栏专栏收录该内容

166 篇文章 2 订阅

订阅专栏

🐯猫头虎带你解决：error Error: certificate has expired 💥

今天有粉丝问猫哥：“🐯猫头虎，我在 Node.js 项目中使用 Yarn 安装包时遇到了一个错误：Error: certificate has expired。你能帮忙解决这个问题吗？” 当然！今天猫头虎就带大家一起深入剖析这个问题的根源，并提供详细的解决方案，让大家轻松摆脱这种常见的SSL证书问题。

📋 问题描述

在使用 yarn install 或其他网络请求相关的操作时，你可能会遇到以下错误：

error Error: certificate has expired
    at TLSSocket.onConnectSecure (node:_tls_wrap:1659:34)
    at TLSSocket.emit (node:events:517:28)
    at TLSSocket._finishInit (node:_tls_wrap:1070:8)
    at ssl.onhandshakedone (node:_tls_wrap:856:12)
info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command.

这个问题主要是由于SSL证书过期，导致 Node.js 无法验证服务器的身份，进而阻止了 Yarn 的包管理操作。

猫头虎是谁？

大家好，我是猫头虎，别名猫头虎博主，擅长的技术领域包括云原生、前端、后端、运维和AI。我的博客主要分享技术教程、bug解决思路、开发工具教程、前沿科技资讯、产品评测图文、产品使用体验图文、产品优点推广文稿、产品横测对比文稿，以及线下技术沙龙活动参会体验文稿。内容涵盖云服务产品评测、AI产品横测对比、开发板性能测试和技术报告评测等。

目前，我活跃在CSDN、51CTO、腾讯云开发者社区、阿里云开发者社区、知乎、微信公众号、视频号、抖音、B站和小红书等平台，全网拥有超过30万的粉丝，统一IP名称为猫头虎或者猫头虎博主。希望通过我的分享，帮助大家更好地了解和使用各类技术产品。

作者名片 ✍️

博主：猫头虎
全网搜索关键词：猫头虎
作者微信号：Libin9iOak
作者公众号：猫头虎技术团队
更新日期：2024年08月08日
🌟 欢迎来到猫头虎的博客 — 探索技术的无限可能！

加入我们AI共创团队 🌐

猫头虎AI共创社群矩阵列表：
- 点我进入共创社群矩阵入口
- 点我进入新矩阵备用链接入口

加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀

部分专栏链接：

🔗 精选专栏：

《面试题大全》 — 面试准备的宝典！
《IDEA开发秘籍》 — 提升你的IDEA技能！
《100天精通鸿蒙》 — 从Web/安卓到鸿蒙大师！
《100天精通Golang（基础入门篇）》 — 踏入Go语言世界的第一步！
《100天精通Go语言（精品VIP版）》 — 踏入Go语言世界的第二步！

🐯 问题分析

这个问题的根本原因是SSL证书的到期。当我们使用 https 请求时，服务器会返回其SSL证书以确认其身份。证书有有效期，过了这个时间，客户端会认为该服务器的证书不再安全，进而抛出错误。

常见场景：

使用 Yarn、npm 安装包时抛出错误。
请求需要 HTTPS 的 API 时，因证书过期导致失败。
访问某些需要 SSL 安全通信的服务器时出现问题。

这是常见的证书过期问题。

🛠️ 解决方案

接下来，我们一起来看看几种常见的解决方案，每种方法都可以帮助你快速恢复开发环境。

1. ⏳ 更新系统证书

系统自带的 SSL 证书可能已经过期，需要手动更新。以下是 Linux 和 Mac 系统的更新步骤：

对于 Linux 用户：

sudo apt-get update
sudo apt-get install --reinstall ca-certificates

对于 Mac 用户：

brew update
brew install curl-ca-bundle

Windows 用户：

你需要手动更新根证书，访问微软官网下载更新包。

2. 🔄 更新 Node.js 版本

有时，证书问题可能是由于 Node.js 版本过旧导致的。可以通过以下命令更新 Node.js：

# 查看当前版本
node -v

# 使用n来更新Node.js（需提前安装n模块）
sudo npm install -g n
sudo n stable

升级 Node.js 到最新版本后，试着重新执行 yarn install。

3. 🔧 忽略证书验证（临时方案，不推荐）

如果你只是想快速绕过此问题，可以选择临时忽略证书验证。但需要注意，这会降低通信的安全性。仅在开发环境中使用！

export NODE_TLS_REJECT_UNAUTHORIZED=0

你可以在 bash 中运行这条命令，再执行 yarn install。不过，生产环境中不建议使用此方法。

4. 💡 更新 Yarn 的 SSL 配置

你也可以通过修改 Yarn 的配置来忽略证书问题。使用以下命令关闭 Yarn 的证书校验：

yarn config set "strict-ssl" false -g

这种方式适用于 Yarn 的全局设置，会关闭 SSL 校验，但需要谨慎使用。

5. 🔑 手动更新过期证书

如果你明确知道哪个证书过期了，可以选择手动更新该证书。以下是通过 OpenSSL 更新证书的方法：

openssl s_client -showcerts -connect example.com:443 </dev/null 2>/dev/null | openssl x509 -outform PEM > ~/example-com.pem
sudo cp ~/example-com.pem /usr/local/share/ca-certificates/
sudo update-ca-certificates

这将下载目标服务器的证书并更新本地证书存储。

📝 避免此类问题的建议

为了避免将来再次遇到此类问题，猫头虎给出以下建议：

定期更新系统证书，尤其是当你频繁依赖网络请求时。
保持 Node.js 和 Yarn 的版本更新，因为新的版本通常修复了旧版中的证书问题。
定期检查你的依赖包的源站，确保使用可信赖的 HTTPS 证书。

📚 参考资料

💬 常见 QA

Q1: 忽略 SSL 证书安全性会有风险吗？

A1: 忽略 SSL 校验确实会降低安全性。推荐仅在开发环境中使用，生产环境必须使用有效证书。

Q2: 如果更新 Node.js 和系统证书还是不行怎么办？

A2: 可以尝试手动更新目标服务器的证书，或检查网络代理配置，确保没有被中间人攻击拦截 SSL 证书。

📊 本文总结

方案	描述	适用场景	是否推荐
更新系统证书	通过命令更新 SSL 证书	系统证书过期	强烈推荐
更新 Node.js	更新 Node.js 版本	Node.js 版本过低	推荐
忽略证书验证	临时忽略证书校验	开发环境	不推荐
更新 Yarn 配置	关闭 Yarn SSL 校验	Yarn SSL 错误	谨慎使用
手动更新证书	手动更新过期的 SSL 证书	特定服务器证书过期	推荐