Rails中render从plain改为json触发500错误，如何返回401响应

当你把render的参数从plain切换为json时，触发了Rails JSON渲染流程的额外逻辑，具体差异如下：

• 调用render plain: xxx时，Rails会直接将传入的字符串作为响应体返回，仅设置Content-Type: text/plain头，全程不会调用控制器的其他上下文方法，所以异常处理流程可以正常执行，返回401状态码。
• 调用render json: xxx时，Rails会触发完整的JSON序列化流程。绝大多数Rails项目的JSON序列化配置（包括Rails内置扩展、ActiveModelSerializers、Jbuilder等常用组件）都会默认将控制器的current_user方法返回值作为序列化上下文注入，用于权限校验、关联数据过滤等场景。此时序列化逻辑会再次调用你覆写的current_user方法，第二次抛出InvalidCredentials异常。

而Rails的rescue_from机制默认不会捕获在异常处理方法内部抛出的同类型异常，因此第二次抛出的InvalidCredentials会被判定为未处理异常，最终返回500错误。

有几种可落地的修复方式：

1. 直接传入序列化完成的JSON字符串
   跳过Rails的自动序列化流程，直接把Hash转成JSON字符串传给json参数，此时不会触发上下文注入逻辑：

def unauthenticated(_error)
  render json: { error: 'text' }.to_json, status: :unauthorized
end

该方式改动最小，不需要修改其他逻辑。

2. 给current_user方法添加调用缓存
   修改current_user方法，确保同一个请求周期内只会抛一次异常：

def current_user
  # 已经调用过一次则直接返回，避免重复抛异常
  return @current_user if instance_variable_defined?(:@current_user)
  @current_user = nil
  raise InvalidCredentials
end

该方式可以从根源避免同一请求内重复触发认证异常。

3. 显式指定跳过序列化上下文
   如果你使用了ActiveModelSerializers这类序列化框架，可以在render时显式关闭上下文注入：

def unauthenticated(_error)
  render json: { error: 'text' }, status: :unauthorized, serialization_context: nil
end

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