使用Sharp Node.js转HEIC为PNG/JPEG时遇不支持编解码器错误

问题描述 #

从AWS S3获取文件并转换为Buffer后，使用Sharp Node.js库将HEIC图片转换为PNG/JPEG时触发错误：

Stack: Error: source: bad seek to 1508850 heif: Unsupported feature: Unsupported codec (4.3000)

涉及代码：

const file = await this.awsS3Service.getObject(fileEntity.awsS3Key);
const body = await this.awsS3Service.streamToBuffer(file.Body as Readable);
const outputBuffer = await sharp(body).toFormat('png').toBuffer();

也曾尝试：

const outputBuffer = await sharp(body).png().toBuffer();

该代码一个月前可正常运行。

解决方案 #

• 更新libheif依赖：Sharp依赖libheif处理HEIC文件，报错中的codec 4.3000属于较新的HEIC编码版本，当前环境的libheif版本过低不支持。需先将libheif更新至支持该编码的版本，再重新安装Sharp（确保Sharp编译时调用新的libheif）。
• 校验文件完整性：确认从S3获取的文件未损坏，可下载文件本地用图片工具打开测试，或对比文件哈希值。若文件损坏，重新上传或修复后再执行转换。
• 升级Sharp版本：检查Sharp是否有适配新HEIC编码的更新版本，执行npm update sharp或yarn upgrade sharp更新后重试。
• 直接处理流：跳过Buffer转换步骤，直接将S3返回的流传入Sharp，避免Buffer转换可能引发的问题：

  const file = await this.awsS3Service.getObject(fileEntity.awsS3Key);
  const outputBuffer = await sharp(file.Body as Readable).toFormat('png').toBuffer();
  

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