338 字
2 分钟
Astro 5.8 更新了最低支持 Node.js 版本
NOTE

使用基于 Astro 框架搭建网页的朋友们注意了,Astro 新发布的5.8版本更新了最低支持的 Node.js 版本,现最低版本为 18.20.8。

突然收到了一封邮件,通知我博客CI/CD自动构建失败了,于是我赶紧登录排查一下。构建失败的是dependabot的PR,日志如下,原因一目了然了,Node.js 版本不支持。

15:23:21.301 Node.js v18.17.1 is not supported by Astro!
15:23:21.301 Please upgrade Node.js to a supported version: ">=18.20.8"
15:23:21.301
15:23:21.303 Cloudflare Pages CI Environment Detected!
15:23:21.304 Additional steps may be needed to set your Node.js version:
15:23:21.304 Documentation: https://docs.astro.build/en/guides/deploy/

查看 官方博客 可知 Astro 5.8 版本更新了最低支持的 Node.js 版本,原因是 Node.js 18 生命周期将结束了。另外,这个版本好像也没有什么特别的更新内容,不过既然更新了一个minor版本,估计是为后续计划做准备吧。

博客中也给出了解决方案,如果你是本地环境的话,需要自行更新 Node.js,如果是CI/CD环境的话可以设置环境变量NODE_VERSION=22或者创建.nvmrc文件。一般来说CI/CD平台都会遵循这两个设置,如果不行的话请查阅平台文档。

.nvmrc
22

从此事可见,更新依赖时检查一下兼容性的重要性。不要盲目合并bot的依赖更新PR。

Astro 5.8 更新了最低支持 Node.js 版本
https://kasuha.com/posts/astro-580-node-ver/
作者
霞葉
发布于
2025-05-23
许可协议
CC BY-NC-SA 4.0
评论加载中...