Sharp.js并发处理多图时部分图片返回错误尺寸（低分辨率）求助

你的代码在并发场景下出现尺寸错误主要有以下几个问题：

• 读写冲突：你两次创建sharp实例读取同一路径文件，且直接写回原文件，并发场景下多个任务同时读写同一个文件时，会出现读取到未完成写入的残缺文件、写入互相覆盖的问题，导致图片解析后尺寸异常
• 元数据冲突：调用rotate()调整图片像素方向后，你又调用了withMetadata()，该方法默认会保留原始图片的orientation元数据标记，后续读取图片时会再次根据该标记做方向计算，最终呈现的尺寸和实际像素尺寸不符，看起来像是低分辨率错误
• 缓存干扰：sharp默认开启了输入文件缓存，短时间内多次读取同路径文件时，可能会读取到修改前的旧缓存数据，导致处理逻辑异常
• 无并发控制：没有对同文件的处理做加锁限制，多个并发任务重复处理同一个文件会放大上述所有问题

修改后的参考代码如下：

// 用简单集合存储正在处理的文件路径，避免重复处理
const processingFiles = new Set()

async function processImage(file) {
  // 同文件已在处理中则直接返回，避免并发冲突
  if (processingFiles.has(file)) return
  processingFiles.add(file)
  try {
    // 仅实例化一次sharp，同时关闭缓存，避免多次读文件数据不一致
    const sharpInstance = sharp(file, { cache: false })
    const data = await sharpInstance.metadata()

    if(data?.orientation) {
      // 旋转后直接输出，无需保留原始orientation标记避免后续尺寸计算错误
      const buffer = await sharpInstance.rotate().toBuffer()
      fs.writeFileSync(file, buffer)
    }
  } finally {
    processingFiles.delete(file)
  }
}

• 新增同文件处理锁，避免同一个路径的图片被多个并发任务同时处理
• 全局只创建一次sharp实例，避免两次读取文件出现数据不一致，同时关闭sharp的输入缓存，确保读取到的始终是最新的文件内容
• 旋转后移除withMetadata()调用，避免保留旧的orientation标记导致后续尺寸计算错误，如果确实需要保留其他元数据，可以指定仅重置orientation字段：withMetadata({ orientation: 1 })
• 高并发场景下建议不要直接写回原文件，先写入临时文件再重命名替换原文件，避免写入过程中出现异常导致原文件损坏

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