猫头虎带你解决：error Error: certificate has expired
🐯猫头虎带你解决：error Error: certificate has expired 💥
今天有粉丝问猫哥：“🐯猫头虎，我在 Node.js 项目中使用 Yarn 安装包时遇到了一个错误：Error: certificate has expired。你能帮忙解决这个问题吗？” 当然！今天猫头虎就带大家一起深入剖析这个问题的根源，并提供详细的解决方案，让大家轻松摆脱这种常见的SSL证书问题。
📋 问题描述
在使用 yarn install 或其他网络请求相关的操作时，你可能会遇到以下错误：
error Error: certificate has expiredat 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语言世界的第二步！
文章目录
- 🐯猫头虎带你解决：**error Error: certificate has expired** 💥
- 📋 问题描述
- 猫头虎是谁？
- 作者名片 ✍️
- 加入我们AI共创团队 🌐
- 加入猫头虎的共创圈，一起探索编程世界的无限可能！ 🚀
- 🐯 问题分析
- 常见场景：
- 🛠️ 解决方案
- 1. ⏳ **更新系统证书**
- 对于 Linux 用户：
- 对于 Mac 用户：
- Windows 用户：
- 2. 🔄 **更新 Node.js 版本**
- 3. 🔧 **忽略证书验证（临时方案，不推荐）**
- 4. 💡 **更新 Yarn 的 SSL 配置**
- 5. 🔑 **手动更新过期证书**
- 📝 避免此类问题的建议
- 📚 参考资料
- 💬 常见 QA
- 📊 本文总结
- 🔮 未来行业发展趋势
- 联系我与版权声明 📩
🐯 问题分析
这个问题的根本原因是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 证书。
📚 参考资料
- Yarn 官方文档
- Node.js SSL 文档
- OpenSSL 安全指南
💬 常见 QA
Q1: 忽略 SSL 证书安全性会有风险吗？
A1: 忽略 SSL 校验确实会降低安全性。推荐仅在开发环境中使用，生产环境必须使用有效证书。
Q2: 如果更新 Node.js 和系统证书还是不行怎么办？
A2: 可以尝试手动更新目标服务器的证书，或检查网络代理配置，确保没有被中间人攻击拦截 SSL 证书。
📊 本文总结
| 方案 | 描述 | 适用场景 | 是否推荐 |
|---|---|---|---|
| 更新系统证书 | 通过命令更新 SSL 证书 | 系统证书过期 | 强烈推荐 |
| 更新 Node.js | 更新 Node.js 版本 | Node.js 版本过低 | 推荐 |
| 忽略证书验证 | 临时忽略证书校验 | 开发环境 | 不推荐 |
| 更新 Yarn 配置 | 关闭 Yarn SSL 校验 | Yarn SSL 错误 | 谨慎使用 |
| 手动更新证书 | 手动更新过期的 SSL 证书 | 特定服务器证书过期 | 推荐 |
🔮 未来行业发展趋势
随着互联网安全要求的日益严格，SSL证书管理将变得越来越重要。自动化证书更新和管理工具（如 Let’s Encrypt）将成为行业标准。对于开发者来说，掌握 SSL/TLS 的基础知识将有助于提升项目的安全性。
加入猫头虎AI共创社群，一起探讨前沿技术！
更多最新 AI 和前端技术资讯，欢迎加入猫头虎 AI 共创社群！
👉 更多信息：有任何疑问或者需要进一步探讨的内容，欢迎点击文末名片获取更多信息。我是猫头虎博主，期待与您的交流！ 🦉💬
联系我与版权声明 📩
- 联系方式：
- 微信: Libin9iOak
- 公众号: 猫头虎技术团队
- 版权声明：
本文为原创文章，版权归作者所有。未经许可，禁止转载。更多内容请访问猫头虎的博客首页。
点击✨⬇️下方名片⬇️✨，加入猫头虎AI共创社群矩阵。一起探索科技的未来，共同成长。🚀