Ruby on Rails多语言多租户I18n.default_locale线程安全问题求助

问题核心 #

你遇到的问题根源是修改全局I18n.default_locale——这个变量是线程共享的，在Puma多线程模式下，并发请求会互相覆盖这个值，导致错误的品牌locale被应用到其他访客的请求中。

优化方案：放弃全局Locale修改，用请求级Locale+回退机制 #

核心思路是：不碰全局的I18n.default_locale，每个请求独立计算带品牌的locale，通过I18n.with_locale（线程安全）绑定到当前请求上下文，同时利用I18n的回退机制处理翻译和模板的降级。

1. 配置I18n回退规则

在config/initializers/i18n.rb中配置品牌locale到通用语言locale的回退，确保没有品牌特定内容时能使用通用翻译/模板：

# 针对固定品牌的配置方式
I18n.fallbacks.map = {
  'brandone-en' => ['en', :en],
  'brandone-fr' => ['fr', :en],
  'brandtwo-en' => ['en', :en],
  'brandtwo-fr' => ['fr', :en]
  # 其他品牌按此格式添加
}

# 通用自动处理逻辑（推荐，适配所有brand-lang格式的locale）
I18n.fallbacks.defaults = lambda do |locale|
  next [:en] unless locale.to_s.include?('-')
  _, lang = locale.to_s.split('-')
  [lang.to_sym, :en]
end

# 加载所有品牌的翻译文件
I18n.load_path += Dir[Rails.root.join('config', 'locales', '**', '*.yml')]

2. 重构set_locale方法，移除全局Locale修改

修改ApplicationController中的set_locale方法，不再修改全局I18n.default_locale，直接为当前请求生成目标locale：

def set_locale(&action)
  # 1. 获取用户请求的语言（优先URL参数，其次浏览器语言）
  requested_lang = params[:locale] || extract_browser_preferred_lang
  # 2. 校验语言合法性，默认回退到英语
  valid_lang = %w[en fr].include?(requested_lang) ? requested_lang : 'en'
  # 3. 生成带品牌标识的locale
  target_locale = "#{valid_lang}-#{site.slug}"

  begin
    # 用线程安全的with_locale绑定当前请求的locale
    I18n.with_locale(target_locale, &action)
  rescue I18n::InvalidLocale
    not_found
  end
end

# 辅助方法：从浏览器请求头提取优先语言
def extract_browser_preferred_lang
  request.env['HTTP_ACCEPT_LANGUAGE']&.scan(/^[a-z]{2}/)&.first || 'en'
end

3. 保持原有路由规则不变

URL仍只暴露通用语言标识（en/fr），路由规则无需修改：

# config/routes.rb
scope '(:locale)', locale: /en|fr/ do
  # 各类路由定义
end

4. 模板与翻译文件的组织

• 模板文件：按品牌locale命名，比如app/views/pages/index.brandone-en.erb，Rails会自动优先加载对应品牌locale的模板，找不到则回退到通用语言模板（如index.en.erb），最后回退到默认模板。
• 翻译文件：按品牌分类存放，比如config/locales/brandone/en.yml、config/locales/brandtwo/fr.yml，I18n会自动加载这些文件，并按照配置的回退规则查找翻译内容。

为什么这个方案有效 #

• I18n.with_locale是线程安全的：它将locale存储在线程局部变量中，每个请求的线程拥有独立的locale值，不会互相干扰。
• 完全避免全局变量修改：不再依赖共享的I18n.default_locale，从根源上解决线程安全问题。
• 兼容原有URL逻辑：访客看到的URL仍保持简洁的en/fr标识，不会暴露品牌内部的locale格式。

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