Rails7如何捕获模型before_save回调错误并展示给前端用户

你之前在save失败分支加提示不生效的核心原因：before_save回调里的网络请求没有做异常捕获，遇到SSL错误、连接超时、目标站点404/500这类问题时，会直接抛出未处理的异常，中断整个请求流程，根本不会走到你写的save判断的else分支。异常会直接被Rails默认异常处理器接住，开发环境抛调试错误页，生产环境返回500错误，自然前端拿不到自定义提示。

核心逻辑是在回调内捕获所有网络请求相关异常，把异常转换成模型校验错误，不要让异常直接抛出，这样@company.save就会正常返回false，走失败分支的响应逻辑。
首先修改模型层的回调代码，不要裸调用Net::HTTP：

# app/models/company.rb
# 仅当URL字段变化时才触发抓取，避免每次保存重复请求、覆盖人工修改的内容
before_save :fetch_page_metadata, if: :url_changed?

private

def fetch_page_metadata
  target_uri = URI.parse(url)
  # 自定义HTTP客户端配置，加超时、SSL参数
  http = Net::HTTP.new(target_uri.host, target_uri.port)
  http.use_ssl = target_uri.scheme == "https"
  http.open_timeout = 5 # 连接超时5秒
  http.read_timeout = 10 # 读取超时10秒
  # 非必要不要关闭SSL验证，会存在中间人攻击风险，证书问题优先升级服务器CA证书包
  # http.verify_mode = OpenSSL::SSL::VERIFY_NONE

  response = http.request(Net::HTTP::Get.new(target_uri.request_uri))
  # 拦截非200响应
  return errors.add(:url, "目标站点无法访问，请检查链接是否有效") unless response.is_a?(Net::HTTPSuccess)

  noko = Nokogiri::HTML(response.body)
  self.title = noko.title&.strip
  # 可扩展提取description、favicon、OG图等其他字段
rescue URI::InvalidURIError
  errors.add(:url, "请输入有效的http/https链接")
rescue Net::OpenTimeout, Net::ReadTimeout, Errno::ECONNREFUSED, Errno::ECONNRESET, SocketError
  errors.add(:url, "连接目标站点超时，请稍后重试或检查链接有效性")
rescue OpenSSL::SSL::SSLError
  errors.add(:url, "目标站点SSL证书配置异常，无法安全访问")
rescue => e
  # 兜底捕获未预期的抓取错误，避免直接抛500
  Rails.logger.error("抓取页面元数据失败: #{e.message}")
  errors.add(:url, "解析链接信息失败，请检查链接是否有效")
  throw(:abort) # 终止后续保存流程
end

再调整控制器的失败响应逻辑，注意Hotwire场景下turbo_stream请求不能只设置flash，必须返回要渲染的页面内容：

def create
  @company = Company.new(company_params)
  @company.user_id = current_user.id
  
  if @company.save
    notice = "Company created."
    respond_to do |format|
      format.html { redirect_to company_path(@company), notice: notice }
      format.turbo_stream { flash.now[:notice] = notice }
    end
  else
    # 直接拼接模型层返回的具体错误，不要用写死的通用提示
    flash.now[:alert] = @company.errors.full_messages.join("，")
    respond_to do |format|
      format.html { render :new, status: :unprocessable_entity }
      format.turbo_stream { render :new, status: :unprocessable_entity }
    end
  end
end

注意：需要在new页面表单顶部预留flash消息、模型错误的渲染位置，否则提示没有展示入口。

在before_save里做同步外网请求是非常差的实践：一是请求阻塞Rails工作线程，并发稍高就会拖垮服务；二是网络抖动直接打断用户提交流程；三是外网异常场景极多，维护成本很高。更优方案按生产可用性优先级排序：

• 异步后台Job抓取（最推荐）
  表单提交时只做URL格式校验，校验通过直接保存记录，元数据抓取逻辑丢到ActiveJob队列异步执行，抓完再更新模型字段。
  执行流程：
  • 用户提交URL，后端校验格式合法就直接保存Company记录，title、description等字段初始留空
  • 保存成功后立刻触发FetchCompanyMetadataJob，传入记录ID
  • Job内执行Nokogiri抓取逻辑，抓完更新对应字段，通过Turbo Stream主动推送内容到前端更新页面；就算抓取失败，也可以通过站内通知等形式告知用户，完全不阻塞用户提交操作
    这个方案完全隔离了网络请求对表单提交主流程的影响，用户点提交立刻能进入详情页，后台慢慢抓取数据即可，是生产环境的标准实现。
• 前端预抓取+后端校验
  用户输入URL失焦时，前端通过轻量后端代理接口拉取目标页元数据，把拿到的title、description填充到表单隐藏域，用户提交时直接把这些字段传给后端，后端只做格式校验和XSS过滤即可，不需要在提交时发外网请求。这个方案响应速度最快，但需要处理跨域问题，且后端不能完全信任前端传值，必须做内容过滤。
• 用before_validation回调代替before_save
  如果一定要同步执行抓取，把回调从before_save挪到before_validation阶段，抓取到内容后再走统一的模型校验流程，错误挂载逻辑更合理，不会出现保存执行到一半回调报错的问题，但本质还是同步阻塞请求，仅适合并发极低的内部系统使用。

• 加基础URL格式校验：模型层增加validates :url, presence: true, format: { with: URI::DEFAULT_PARSER.make_regexp(%w[http https]) }，非法格式直接在校验层拦截，不需要发外网请求
• 加抓取缓存：对已经抓取过的URL做缓存，以URL哈希为key，抓取到的元数据存在Rails缓存中设置7天有效期，同一个URL不需要重复发起请求
• 优化元数据提取逻辑：优先读取页面的og:title/og:description/og:image这类OG标签内容，读不到再回退到title、meta description标签，提取的内容质量更高
• 所有抓取到的内容必须做HTML转义，防止目标页面title、描述中夹带恶意脚本，避免XSS风险
• 生产环境定期更新服务器的CA证书包，从根源解决大部分SSL证书验证问题，不要随意关闭SSL验证

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