Rails7中ActiveRecord唯一性验证（带scope和大小写不敏感）失效

你当前的问题出在：case_sensitive: false参数只作用于被验证的字段attr1，而scope指定的attr2和attr3仍然会以大小写敏感的方式进行匹配。所以当你把这两个字段的值转成大写后，Rails会判定这是一组新的字段组合，不会触发唯一性验证失败。

解决办法 #

方案1：存储时统一字段大小写（推荐）

在模型中添加回调，将三个字段统一转换为小写（或大写）后再存入数据库，这样不管输入的是大写还是小写，最终存储的值都是一致的，验证和数据库层面都能保证唯一性：

class Model < ApplicationRecord
  validates :attr1, uniqueness: { scope: %i[attr2 attr3], case_sensitive: false }

  before_save :normalize_case_sensitive_attributes

  private

  def normalize_case_sensitive_attributes
    self.attr1 = attr1.downcase if attr1.present?
    self.attr2 = attr2.downcase if attr2.present?
    self.attr3 = attr3.downcase if attr3.present?
  end
end

修改后你的测试用例会自动通过，因为存入数据库的都是统一大小写的值，新建记录时转大写的字段会被回调转成小写，和已有记录匹配。

方案2：自定义验证器手动校验

如果不想修改存储的字段值，可以自定义验证逻辑，手动查询数据库时忽略三个字段的大小写：

class Model < ApplicationRecord
  validate :unique_case_insensitive_combo

  private

  def unique_case_insensitive_combo
    # 排除当前记录（适配更新场景）
    query = Model.where(
      "LOWER(attr1) = ? AND LOWER(attr2) = ? AND LOWER(attr3) = ?",
      attr1&.downcase, attr2&.downcase, attr3&.downcase
    )
    query = query.where.not(id: id) if persisted?

    if query.exists?
      errors.add(:attr1, "与attr2、attr3的组合已存在（忽略大小写）")
    end
  end
end

注意：LOWER函数在主流数据库（PostgreSQL、MySQL、SQLite）中都支持，确保字段为字符串类型即可。

额外建议：添加数据库层面的唯一索引 #

为了避免并发场景下出现数据重复，建议在数据库层面添加忽略大小写的唯一索引：

• PostgreSQL：可以使用表达式索引或者启用citext扩展
  表达式索引迁移示例：

  class AddCaseInsensitiveUniqueIndexToModels < ActiveRecord::Migration[7.0]
    def change
      add_index :models, 
                ["LOWER(attr1)", "LOWER(attr2)", "LOWER(attr3)"], 
                unique: true,
                name: "index_models_on_lower_attrs"
    end
  end
  

  citext扩展示例：

  class EnableCitextAndChangeColumns < ActiveRecord::Migration[7.0]
    def change
      enable_extension :citext
      change_column :models, :attr1, :citext
      change_column :models, :attr2, :citext
      change_column :models, :attr3, :citext
      add_index :models, [:attr1, :attr2, :attr3], unique: true
    end
  end
  

• MySQL：设置字段的 collation 为不区分大小写的类型（如utf8mb4_general_ci），然后添加普通唯一索引即可：

  class AddUniqueIndexToModels < ActiveRecord::Migration[7.0]
    def change
      change_column :models, :attr1, :string, collation: "utf8mb4_general_ci"
      change_column :models, :attr2, :string, collation: "utf8mb4_general_ci"
      change_column :models, :attr3, :string, collation: "utf8mb4_general_ci"
      add_index :models, [:attr1, :attr2, :attr3], unique: true
    end
  end
  

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