使用webp-ffi gem上传文件报错、部分JPG转WebP失败的原因是什么？

Unsupported color conversion request和WebP::EncoderError Exception: Cannot read input picture file两个报错都指向webp-ffi底层依赖的libwebp库无法识别输入的JPG文件，常见触发原因有三类：

• 部分JPG使用了libwebp默认不支持的色彩空间，比如CMYK、Adobe RGB或者内嵌了非标准ICC色彩配置文件，libwebp无法完成色彩空间到webp兼容格式的转换，就会抛出色彩转换相关的报错。
• 部分JPG是相机直出、小众修图工具导出的，写入了非标准的帧头信息、自定义元数据，或者存在局部编码损坏，libwebp的文件预校验逻辑识别为无效文件，直接抛出无法读取输入文件的错误。
• 少数JPG使用了非常规的色度子采样格式，比如非标准的4:2:2、4:4:4采样变体，也会导致libwebp解析失败。

你通过谷歌工具重新转码JPG后恢复正常，是因为转码过程会自动将非标准色彩空间强制转换为通用的sRGB格式，同时清理无效元数据、修正帧头编码错误，输出符合通用规范的JPG文件，自然可以被libwebp正常识别。

不用依赖手动转码的前置操作，可以在代码里加自动预处理逻辑：

1. 调用WebP.encode前用mini_magick对输入图片做标准化处理，示例代码如下：

# 预处理异常JPG文件
normalized_temp_path = "#{path}_normalized.jpg"
MiniMagick::Image.open(path) do |img|
  img.colorspace "sRGB" # 强制转为sRGB色彩空间
  img.strip # 清除无效ICC配置、自定义元数据
  img.write(normalized_temp_path)
end

# 用预处理后的文件编码webp
WebP.encode(normalized_temp_path, webp_path, options)

# 清理临时文件
File.delete(normalized_temp_path) if File.exist?(normalized_temp_path)

# 后续原有逻辑保持不变
@filename = webp_path.split('/').pop
@file = CarrierWave::SanitizedFile.new(
  tempfile: webp_path,
  filename: webp_path,
  content_type: 'image/webp'
)

2. 升级webp-ffi gem到最新版本，同时更新系统依赖的libwebp库到1.2.0以上版本，新版本已经扩展了对更多色彩空间、JPG编码格式的支持，可覆盖大部分异常场景。

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