Carrierwave升级至2.2.X后cache_stored_file!无法获取缓存文件

问题根源 #

• 在CarrierWave 1.3.x版本中，cache_stored_file!会将远程Fog存储的文件下载到本地，并让file对象指向本地实体文件，因此可以正常调用to_file。但2.x+版本对Fog存储的实现做了核心调整：
  1. CarrierWave::Storage::Fog::File不再提供to_file方法——云存储的文件本身并非本地文件系统中的实体，该方法从设计上就不再适配此类场景。
  2. cache_stored_file!返回200仅表示远程文件请求成功，但新版本中它不会自动将文件持久化到本地路径，导致file.path指向的路径实际不存在，自然无法通过to_file获取有效文件对象。

解决方案 #

要获取本地可操作的文件对象，需要主动将远程文件下载到本地临时文件，推荐两种实现方式：

方式1：使用download!方法直接生成临时文件 #

修改原files方法如下：

def files
  signable_template.signable_documents.map do |sd|
    # 将远程文件下载为临时文件对象
    temp_file = sd.document.download!
    # 可选：手动补充文件扩展名，适配业务对文件格式的校验需求
    temp_file.path += ".docx"
    temp_file
  end
end

download!方法会返回Tempfile对象，可直接用于后续文件操作，临时文件会在程序退出后自动清理。

方式2：手动读取文件流并写入临时文件 #

如果需要更精细的控制（比如指定临时文件目录、编码），可以通过文件流手动处理：

def files
  signable_template.signable_documents.map do |sd|
    temp_file = Tempfile.new(["signable_doc", ".docx"], encoding: 'binary')
    temp_file.write(sd.document.file.read)
    temp_file.rewind # 将文件指针重置到开头，确保后续读取操作正常
    temp_file
  end
end

注意事项 #

• 若需提前清理临时文件，可在使用完毕后调用temp_file.close!
• 如果业务需要持久化这些文件，需手动将临时文件移动到指定的持久化目录

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