Ruby on Rails配置带版本路径的CDN资源加载问题求助

需求可行性确认 #

这个需求完全可行，核心是要分别对asset pipeline和shakapacker做针对性配置，既实现CDN+版本前缀的资源引用，又避免本地文件查找冲突。

具体配置方案 #

1. 正确分离Asset Host与版本前缀 #

不要把版本路径直接写入config.asset_host（asset pipeline会将其视为纯域名，无法正确解析路径），而是通过自定义路径生成逻辑来添加版本前缀：

# config/environments/production.rb
config.asset_host = "cdn.url.com"
config.action_controller.asset_path = lambda { |asset_path, request|
  "/v1.2.3#{asset_path}"
}

这个配置会让所有asset pipeline生成的资源路径（包括CSS里的图片、字体，以及image_tag等辅助方法生成的URL）自动带上/v1.2.3前缀，最终输出cdn.url.com/v1.2.3/assets/xxx.png这类格式的地址。

2. Shakapacker的版本前缀配置 #

在Shakapacker中直接指定打包文件的输出路径，确保生成的引用路径包含版本号：

静态配置（适合固定版本）

# config/shakapacker.yml
production:
  public_output_path: packs/v1.2.3

动态配置（适合从环境变量读取版本）

# config/initializers/shakapacker.rb
Shakapacker.configure do |config|
  if Rails.env.production?
    config.public_output_path = "packs/#{ENV['APP_VERSION']}"
  end
end

配置后，Shakapacker会将打包文件输出到public/packs/v1.2.3/，结合asset host后，最终引用路径为cdn.url.com/v1.2.3/packs/runtime.12345.js。

3. 解决本地文件查找问题 #

之前设置config.assets.prefix = "/v1.2.3"导致本地找不到文件，是因为该配置会改变Rails本地资源的查找路径（会去public/v1.2.3/assets/查找，但实际资源在public/assets/）。只需在版本前缀逻辑中区分环境即可：

# config/environments/production.rb
config.action_controller.asset_path = lambda { |asset_path, request|
  Rails.env.production? ? "/v1.2.3#{asset_path}" : asset_path
}

本地开发时使用默认路径，生产环境才添加版本前缀，避免冲突。

4. Dart-Sass-Rails的URL处理 #

确保SCSS中使用Rails提供的资源辅助函数，而非原生url()：

.logo {
  background-image: asset-url('logo.png');
}

如果习惯用原生url()，可开启自动转换：

# config/initializers/assets.rb
Rails.application.config.sass.asset_urls = true

这样dart-sass-rails编译时会自动将url('logo.png')转换为带版本前缀的路径。

验证步骤 #

1. 执行rails assets:precompile，检查public/assets/和public/packs/v1.2.3/下的文件是否生成正常
2. 查看编译后的CSS文件，确认图片/字体引用路径包含CDN域名和版本前缀
3. 查看页面HTML源码，确认packs资源的引用路径符合预期

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