Rails中如何自定义ActiveRecord::RecordNotUnique异常以包含重复数据条目信息

针对你遇到的ActiveRecord::RecordNotUnique异常（MySQL唯一键冲突），想要全局统一处理并返回包含现有重复数据的响应，完全可以通过Rails的全局异常捕获机制实现，避免在每个控制器中重复编写错误逻辑。下面是具体的实现方案：

1. 全局捕获并处理重复异常 #

在ApplicationController中添加全局异常处理，解析MySQL的错误信息，提取重复的字段值和对应表/字段，然后查询出重复的现有记录并返回统一格式的响应。

class ApplicationController < ActionController::Base
  # 全局捕获ActiveRecord唯一键重复异常
  rescue_from ActiveRecord::RecordNotUnique, with: :handle_duplicate_record_error

  private

  def handle_duplicate_record_error(exception)
    # 使用正则从错误消息中提取关键信息：重复值、表名、字段名
    if exception.message.match?(/Duplicate entry '(.*)' for key '(.*)\.(.*)'/)
      duplicate_value = Regexp.last_match(1)
      table_name = Regexp.last_match(2)
      column_name = Regexp.last_match(3)

      # 根据表名获取对应的模型类（遵循Rails约定：abc -> Abc）
      model_class = table_name.classify.constantize
      # 查询现有重复记录
      existing_record = model_class.find_by(column_name => duplicate_value)

      # 构建符合需求的响应数据
      response_payload = {
        message: exception.message,
        "existing_#{table_name.singularize}_with_same_#{column_name}": existing_record
      }

      # 返回409 Conflict状态码和响应数据
      render json: response_payload, status: :conflict
    else
      # 处理无法解析的异常情况，返回原错误信息
      render json: { message: exception.message }, status: :conflict
    end
  end
end

2. 效果说明 #

当任何控制器（包括嵌套属性场景下的父模型保存操作）触发唯一键重复异常时，会自动返回如下格式的响应：

{
  "message": "Mysql2::Error: Duplicate entry 'xyz1' for key 'abc.xyz'",
  "existing_abc_with_same_xyz": {
    "id": 1,
    "xyz": "xyz1",
    // 其他字段...
  }
}

3. 注意事项 #

• 模型命名约定：代码依赖Rails的表名与模型名约定（比如表abc对应模型Abc），如果你的项目有自定义命名规则，需要调整model_class = table_name.classify.constantize这部分逻辑。
• 性能考量：find_by查询依赖唯一索引（本来就是触发异常的索引），所以查询效率很高，不会造成性能问题。
• 嵌套属性适配：即使Abc作为其他资源的nested_attributes，父模型保存时触发的重复异常依然会被全局捕获处理，无需单独修改父控制器逻辑。

可选方案：自定义异常类 #

如果你需要在某些场景下手动抛出或捕获自定义异常，可以先定义一个继承自原异常的自定义类：

# app/exceptions/duplicate_record_error.rb
class DuplicateRecordError < ActiveRecord::RecordNotUnique
  attr_reader :existing_record

  def initialize(message, existing_record)
    super(message)
    @existing_record = existing_record
  end
end

然后在全局处理方法中抛出这个自定义异常（替代直接返回响应），后续可以在特定控制器中单独捕获处理，但这种方式不如全局直接返回响应简洁，适合需要更灵活处理的场景。

内容的提问来源于stack exchange，提问作者Akhil S R