引入CarrierWaveDirect的CarrierWave上传器非直传时生成Key异常

算力阿峰

2026-8-11

问题分析与解决方案

问题根源

这是CarrierWaveDirect 0.0.16+版本的兼容性bug，新版本对key方法的重构没有兼顾非直传场景：

非直传流程中，文件先被缓存到本地，此时present?返回true，触发新版本逻辑去调用模型的#{mounted_as}_identifier方法
但这个字段要等到模型保存时才会被CarrierWave写入标识符，此时调用返回nil，导致key被拼接成store_dir/nil（nil被当作空字符串处理），也就是你看到的/uploads/uploads，且每次都用相同的错误路径导致文件覆盖

0.0.15版本基于url生成key，非直传时url是缓存文件的路径，能正确解析出相对路径作为key，所以没有问题；而不引入CarrierWaveDirect时，用的是CarrierWave原生的key生成逻辑，也能正常工作。

临时解决方案

方案1：重写上传器的`key`方法，兼容两种上传方式

在你的上传器类中重写key方法，判断当前场景分别处理：

class YourUploader < CarrierWave::Uploader::Base
  include CarrierWaveDirect::Uploader

  def key
    return @key if @key.present?
    if present?
      # 优先取直传的identifier，无则用缓存文件的文件名生成key
      identifier = model.send("#{mounted_as}_identifier") || File.basename(file.path)
      self.key = [store_dir, identifier].join("/")
    else
      guid = SecureRandom.uuid
      @key = [store_dir, guid, FILENAME_WILDCARD].join("/")
    end
    @key
  end
end