使用sharp合成2300张图片时出现bus error错误如何解决？

你遇到的bus error本质是sharp底层依赖的libvips在一次性处理过多合成图层时出现的内存访问异常，2300个图层同时加载会触发内存超限/重复解析SVG导致的资源溢出，单独关闭缓存无法解决这个问题。

方法1：分批次合成（最稳定） #

不要一次性把2300个图层全部传入composite，每次处理固定数量的图层，用前一次合成的结果作为下一次的底图循环处理，示例代码如下：

const BATCH_SIZE = 50; // 可根据实际运行情况调整，建议50-100之间

async function batchComposite(locations) {
  // 提前把SVG转成固定尺寸的png buffer，避免重复解析
  const pinPngBuffer = await sharp(pinSvg)
    .resize(pinWidth, pinHeight)
    .png()
    .toBuffer();

  // 初始化底图
  let baseBuffer = await sharp({
    create: {
      width: 256,
      height: 256,
      channels: 4,
      background: { r: 0, g: 0, b: 0, alpha: 0 },
    },
  }).png().toBuffer();

  // 拆分点位分批次处理
  for (let i = 0; i < locations.length; i += BATCH_SIZE) {
    const batchLocations = locations.slice(i, i + BATCH_SIZE);
    const batchImages = batchLocations.map(([x, y]) => ({
      input: pinPngBuffer,
      blend: "add",
      left: x - Math.floor(pinWidth / 2),
      top: y - pinHeight,
    }));
    // 批次合成
    baseBuffer = await sharp(baseBuffer)
      .composite(batchImages)
      .png()
      .toBuffer();
  }

  // 最终结果就是baseBuffer
  return baseBuffer;
}

方法2：调整sharp运行参数（配合方法1使用效果更好） #

• 降低sharp并发数，避免多线程同时处理大量图层时的内存冲突：在代码开头添加sharp.concurrency(1)
• 如果你使用的是苹果硅（M系列）设备，可尝试重新编译sharp适配本地架构：执行npm rebuild sharp --build-from-source
• 关闭不必要的优化：sharp.simd(false)可避免部分SIMD指令兼容导致的访问错误

补充优化点 #

你当前代码中重复传入SVG buffer会导致sharp每次合成都要解析一次SVG，提前转成PNG buffer可以减少90%以上的解析开销，也能避免SVG多次渲染的一致性问题。

内容的提问来源于stack exchange，提问作者Antonio Gamiz Delgado