解决 Astro 无法转换图像的问题

[CouldNotTransformImage] Could not transform image /_astro/淘工厂购买的垃圾U盘.B6JJlWAT.jpg. See the stack trace for more information.

Hint:

This is often caused by a corrupted or malformed image. Re-exporting the image from your image editor may fix this issue.

Error reference:

https://docs.astro.build/en/reference/errors/could-not-transform-image/ 🔗

昨天,我在更新一篇首次引入图片的文章时,遭遇了一些状况。在本地运行 pnpm dev 指令时,程序并未报错,所以我便放心地将内容推送到 Github,触发 Vercel 部署。然而,意想不到的问题出现了 。

我采用 pnpm 来管理博客项目的依赖包。经过排查,发现此次报错是由 pnpm 严格的包管理机制所致。Astro 默认的图像服务是 Sharp,尽管 Sharp 属于 Astro 的依赖项,但当使用 pnpm 作为包管理工具时,需要手动将 Sharp 安装到项目中。

解决方法很简单,在命令行中执行:

pnpm add sharp

完成安装后,问题便顺利解决,成功完成了部署。

若对以上内容进行再创作,需遵循 CC BY-NC-SA 4.0 许可协议,在分享时需注明原作者且以相同方式分享。