如何使用CarrierWave对接Azure云存储？现存方案遇依赖兼容问题

针对你遇到的旧gem未维护、fog-azure-rm依赖冲突的问题，这里提供两种现代可行的对接方案：

方案一：使用维护中的carrierwave-azure-storage gem #

这是目前活跃维护的CarrierWave Azure适配gem，兼容较新的Ruby/Rails版本，无需降级faraday等核心依赖，能直接复用原有CarrierWave逻辑。

步骤： #

1. 在Gemfile中添加gem：

gem 'carrierwave-azure-storage'

执行bundle install完成安装。

2. 替换config/initializers/carrier_wave.rb的配置：

CarrierWave.configure do |config|
  if Rails.application.config.ci
    config.storage = :file
    config.enable_processing = false
  else
    config.storage = :azure_storage
    # 从应用配置读取Azure存储信息（建议存于环境变量或加密配置中）
    config.azure_storage_account_name = Rails.application.config.azure_storage_account_name
    config.azure_storage_access_key = Rails.application.config.azure_storage_access_key
    config.azure_storage_container = Rails.application.config.azure_storage_container_name

    # 可选：若使用SAS Token而非账号密钥，替换为以下配置
    # config.azure_storage_sas_token = Rails.application.config.azure_storage_sas_token
    # config.azure_storage_use_sas = true

    # 可选：若使用Azure AD服务主体认证，配置如下
    # config.azure_storage_client_id = Rails.application.config.azure_ad_client_id
    # config.azure_storage_client_secret = Rails.application.config.azure_ad_client_secret
    # config.azure_storage_tenant_id = Rails.application.config.azure_ad_tenant_id
    # config.azure_storage_use_azure_ad = true
  end
end

该gem支持多种认证方式，适配最新Azure Blob存储API，不会引发依赖降级问题。

方案二：基于Azure官方SDK自定义存储适配器 #

如果不想依赖第三方CarrierWave插件，可以直接使用Azure官方的azure-storage-blob SDK编写自定义存储适配器，完全可控且兼容最新依赖。

步骤： #

1. 添加官方SDK到Gemfile：

gem 'azure-storage-blob'

执行bundle install完成安装。

2. 创建自定义存储适配器文件app/uploaders/azure_blob_storage.rb：

class AzureBlobStorage < CarrierWave::Storage::Abstract
  def store!(file)
    # 上传文件到Azure Blob容器
    container = azure_blob_client.get_container(Rails.application.config.azure_storage_container_name)
    blob = container.create_block_blob(
      file.original_filename,
      file.read,
      content_type: file.content_type
    )
    AzureBlob.new(blob, self)
  end

  def retrieve!(identifier)
    # 根据文件名获取Blob
    container = azure_blob_client.get_container(Rails.application.config.azure_storage_container_name)
    blob = container.get_blob(identifier)
    AzureBlob.new(blob, self)
  end

  private

  def azure_blob_client
    @azure_blob_client ||= Azure::Storage::Blob::BlobService.create(
      storage_account_name: Rails.application.config.azure_storage_account_name,
      storage_access_key: Rails.application.config.azure_storage_access_key
    )
  end
end

# Blob对象包装类，实现CarrierWave所需的基础方法
class AzureBlob
  def initialize(blob, storage)
    @blob = blob
    @storage = storage
  end

  # 返回Blob的访问URL
  def url
    @storage.azure_blob_client.generate_blob_url(
      Rails.application.config.azure_storage_container_name,
      @blob.name
    )
  end

  # 实现删除方法（按需添加）
  def delete
    @storage.azure_blob_client.delete_blob(
      Rails.application.config.azure_storage_container_name,
      @blob.name
    )
  end

  # 实现是否存在的方法（按需添加）
  def exists?
    @storage.azure_blob_client.get_blob_properties(
      Rails.application.config.azure_storage_container_name,
      @blob.name
    )
    true
  rescue Azure::Core::Http::HTTPError
    false
  end
end

3. 在CarrierWave配置中指定自定义存储：

CarrierWave.configure do |config|
  if Rails.application.config.ci
    config.storage = :file
    config.enable_processing = false
  else
    config.storage = AzureBlobStorage
  end
end

或者在单个上传器中指定（灵活适配不同上传场景）：

class AvatarUploader < CarrierWave::Uploader::Base
  storage AzureBlobStorage unless Rails.application.config.ci
end

这种方案完全基于官方SDK，可根据业务需求定制上传/下载逻辑，避免第三方依赖的潜在问题。

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