如何使用Shrine的DefaultUrl插件生成S3静态资源完整URL

不需要硬编码host、也不需要单独读取环境变量拼接地址，直接复用Shrine已有的S3存储配置即可，完全避免配置重复维护的问题。

核心实现逻辑 #

Shrine初始化时配置的S3存储实例本身自带URL生成能力，和正常上传文件后生成访问地址的逻辑完全一致，直接在default_url块内调用该方法即可自动生成符合配置的完整绝对URL：

class AvatarUploader < Shrine
  plugin :default_url

  Attacher.default_url do |options|
    # 读取已配置的目标存储实例，默认头像存在公共存储就换对应存储key
    target_storage = Shrine.storages[:store]
    # 调用存储原生url方法，和普通文件生成URL用同一套逻辑
    target_storage.url("user_avatar.png", public: true)
  end
end

方案优势 #

• 无重复配置：所有S3端点、桶名、协议、自定义CDN域名、路径样式配置完全复用Shrine初始化时的存储配置，后续修改存储相关配置时不需要同步修改default_url逻辑
• 全场景兼容：不管是原生AWS S3，还是S3兼容的对象存储（MinIO、Cloudflare R2、国内云厂商OSS等），都能正确生成访问地址
• 自动适配配置规则：如果存储配置了URL前缀、强制路径样式、自定义域名等参数，生成的默认地址会自动适配，不会出现拼接错误

注意事项 #

• 如果默认头像存放的存储不是默认的:store（比如单独配置了公共资源存储:public_store），将Shrine.storages[:store]替换为对应存储的key即可
• 调用url方法时传入public: true参数，和公开资源的URL生成规则保持一致，避免生成带临时签名的私有地址
• 如果默认头像存放在存储的子目录下，直接传入完整路径即可，比如"assets/defaults/user_avatar.png"，存储实例会自动处理路径拼接

内容的提问来源于stack exchange，提问作者R. Sierra