Rails中如何结合Locale实现大小写不敏感的列唯一性验证？

你遇到的问题是translation_uniqueness验证器的case_sensitive参数未生效，这是因为部分多语言gem（比如Globalize）的默认翻译唯一性验证器并未正确实现该参数的逻辑，尤其是针对哈希形式存储的多语言值。以下是两种可行的解决方案：

方案一：自定义模型验证方法 #

直接在模型中编写自定义验证逻辑，手动检查每个locale下name值的不区分大小写唯一性：

class YourModel < ApplicationRecord
  # 假设你使用Globalize管理多语言翻译，已配置translations_for :name, :description
  translates :name, :description

  validate :name_translations_case_insensitive_uniqueness

  private

  def name_translations_case_insensitive_uniqueness
    I18n.available_locales.each do |locale|
      current_name = self.name_translations[locale.to_s]
      next if current_name.blank?

      # 构建查询：排除当前记录，匹配对应locale下小写后的name值
      exists_duplicate = self.class.joins(:translations)
                                  .where.not(id: self.id)
                                  .where("LOWER(translations.name) = ? AND translations.locale = ?", current_name.downcase, locale.to_s)
                                  .exists?

      if exists_duplicate
        errors.add(:name, :taken, message: "#{current_name} (locale: #{locale}) 已存在", locale: locale)
      end
    end
  end
end

关键说明： #

• 遍历所有可用locale，逐个检查对应翻译值的唯一性
• 使用LOWER()函数统一转换为小写进行比较（兼容PostgreSQL/MySQL等主流数据库）
• 通过where.not(id: self.id)排除当前记录本身，避免新增/更新时的自我冲突

方案二：自定义验证器（可复用） #

如果多个模型都需要类似验证，可以封装成自定义验证器，提升代码复用性：

# 在app/validators/case_insensitive_translation_uniqueness_validator.rb中创建自定义验证器
class CaseInsensitiveTranslationUniquenessValidator < ActiveModel::EachValidator
  def validate_each(record, attribute, value)
    locale = options[:locale]
    return unless locale.present?

    current_value = record.send("#{attribute}_translations")[locale.to_s]
    return if current_value.blank?

    # 构建不区分大小写的唯一性查询
    duplicate_exists = record.class.joins(:translations)
                                  .where.not(id: record.id)
                                  .where("LOWER(translations.#{attribute}) = ? AND translations.locale = ?", current_value.downcase, locale.to_s)
                                  .exists?

    if duplicate_exists
      record.errors.add(attribute, :taken, options.merge(value: current_value))
    end
  end
end

# 在模型中使用自定义验证器
class YourModel < ApplicationRecord
  translates :name, :description

  I18n.available_locales.each do |locale|
    validates :description, translation_uniqueness: { locale: locale }
    validates :name, case_insensitive_translation_uniqueness: { locale: locale }
  end
end

性能优化建议 #

为了避免大量数据下的查询性能问题，建议在translations表上创建函数索引：

-- PostgreSQL
CREATE INDEX index_translations_name_lower_locale ON translations (LOWER(name), locale);

-- MySQL
CREATE INDEX index_translations_name_lower_locale ON translations (LOWER(name), locale);

这个索引会加速LOWER(name)和locale的组合查询，确保验证逻辑高效执行。

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