Ruby on Rails：CarrierWave图片版本未生成问题修复咨询

我在运行Retrospring项目时遇到一个问题：上传头像后，页面请求的头像URL是/users/profile_pictures/112/951/283/757/351/898/medium/io.png，但这个路径在项目的public目录下不存在，只有public/users/profile_pictures/112/951/283/757/351/898/original/io.png文件。

相关CarrierWave配置如下：

ProfilePictureUploader代码 #

class ProfilePictureUploader < BaseUploader
  def default_url(*args)
    "/images/#{[version_name || args.first, 'no_avatar.png'].compact.join('/')}"
  end

  version :large do
    process resize_to_fit: [500, 500]
  end
  version :medium do
    process resize_to_fit: [256, 256]
  end
  version :small do
    process resize_to_fit: [80, 80]
  end
end

BaseUploader代码 #

class BaseUploader < CarrierWave::Uploader::Base
  include CarrierWave::Compatibility::Paperclip
  include CarrierWave::MiniMagick
  include CarrierWave::Backgrounder::Delay

  storage :fog

  # Store original size
  version :original

  process :remove_animation
  process :cropping

  def content_type_whitelist = %w[image/jpeg image/gif image/png]

  def store_dir = "/uploads/#{model.class.to_s.underscore}/#{mounted_as}/#{model.id}"

  def size_range = (1.byte)..(5.megabytes)

  def paperclip_path
    return "/users/:attachment/:id_partition/:style/:basename.:extension" if APP_CONFIG["fog"].blank?

    "users/:attachment/:id_partition/:style/:basename.:extension"
  end

  def cropping
    x = model.public_send("#{mounted_as}_x")
    y = model.public_send("#{mounted_as}_y")
    w = model.public_send("#{mounted_as}_w")
    h = model.public_send("#{mounted_as}_h")

    manipulate! do |image|
      image.crop "#{w}x#{h}+#{x}+#{y}"
    end
  end

  def remove_animation
    return unless content_type == "image/gif"

    manipulate!(&:collapse!)
  end
end

问题原因分析 #

1. 后台任务未执行：BaseUploader引入了CarrierWave::Backgrounder::Delay，头像的裁剪和版本生成是异步处理的。如果后台任务进程未启动，medium这类子版本图片不会被生成。
2. 异步配置与本地环境冲突：本地开发时若未正确配置后台任务处理器（如Sidekiq），异步任务会堆积，导致版本文件缺失。
3. 存储配置差异：storage :fog表示使用云存储，但本地public目录仅存在original文件，说明本地环境未同步云存储的版本文件，或本地未触发版本生成逻辑。

解决方案 #

1. 启动后台任务进程 #

项目依赖CarrierWave::Backgrounder处理异步任务，需启动Sidekiq：

bundle exec sidekiq

重启服务后重新上传头像，检查后台任务执行日志，确认版本文件生成。

2. 本地调试临时禁用异步处理 #

注释掉BaseUploader中的后台处理引入，让版本生成同步执行：

# include CarrierWave::Backgrounder::Delay

调试完成后恢复该配置即可。

3. 手动重新生成缺失版本 #

通过Rails控制台为已上传的头像重新生成所有版本：

user = User.find(112951283757351898) # 替换为实际用户ID
user.profile_picture.recreate_versions!

4. 调整本地存储配置 #

若本地开发不需要云存储，修改BaseUploader的存储方式为本地文件存储：

# storage :fog
storage :file

此时文件会生成在public/uploads目录下，CarrierWave会自动处理URL路径映射。

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