AWS Lambda中Sharp转换HEIC为WebP失败问题求助

错误核心原因 #

报错中的heif: Error while loading plugin: No decoding plugin installed for this compression format是关键——当前Sharp依赖的libheif库缺少HEIC解码所需的插件。arm64架构下，Sharp的默认预编译包并未包含HEIC解码支持，导致无法处理该格式文件；附带的source: bad seek to xxx通常是解码失败引发的次生错误。

解决方向 #

• 自定义编译Sharp（适配Lambda arm64环境）
  Lambda运行的是Amazon Linux 2 arm64系统，需在同架构环境下编译Sharp以启用HEIC支持：

  1. 用arm64版Amazon Linux 2容器搭建编译环境：docker run -it --platform linux/arm64 amazonlinux:2
  2. 安装编译依赖：yum install -y gcc-c++ make libvips-devel libheif-devel
  3. 初始化Node.js项目，安装Sharp时强制从源码编译并启用libheif：npm install sharp --build-from-source --with-libheif
  4. 将编译完成的node_modules目录打包，替换Lambda函数原有的依赖包。

• 升级Sharp版本
  旧版Sharp对arm64架构的HEIC支持不完善，执行npm update sharp升级到最新版后重新测试。

• 排除文件本身问题
  bad seek错误可能由损坏的HEIC文件引发，先确认测试用的HEIC文件可正常打开、未损坏。

• 使用Lambda层补充解码插件
  编译包含HEIC解码插件的libheif库，打包成Lambda层附加到函数上，让Sharp能加载到所需插件。

内容的提问来源于stack exchange，提问作者lkp