Ruby on Rails开发JSON API返回空响应体问题咨询

核心原因 #

• show动作存在逻辑冲突：控制器顶部通过before_action为show动作绑定了set_person回调，按常规Rails约定，set_person会提前查询@person实例变量，但你在show动作内部又重复写了@person = Person.find_by(id: params[:id])查询逻辑。如果set_person方法中包含「记录不存在直接返回响应」的判断、且未加return中断执行，会触发重复渲染错误，Rails API模式下遇到这类未捕获的DoubleRenderError时，经常不会抛出明确异常，直接返回空响应体。
• 查询空值无兼容处理：show动作使用的find_by方法在匹配不到对应id记录时会返回nil，如果你项目中集成了active_model_serializers之类的序列化gem，且序列化逻辑未对nil值做兼容，会直接渲染出空响应体。如果你的set_person方法用的是Person.find(params[:id])写法，查询不到记录时会抛出ActiveRecord::RecordNotFound异常，若父类ApiController没有配置对应异常捕获返回404，也可能被框架默认处理为空响应。
• 父类逻辑干扰：如果父类ApiController中配置了全局after_action回调、或者错误混入了Web端页面渲染逻辑，可能会覆盖动作内的render json结果，清空响应体。

修复方案 #

• 统一查询逻辑，删除show动作内的重复查询，补全set_person的异常处理，移除API模式下不需要的edit动作回调，参考代码如下：

class Api::V1::PeopleController < ApiController
  # API模式不需要edit、new页面动作，从回调列表移除
  before_action :set_person, only: %i[show update destroy]

  # GET /api/v1/people
  def index
    @people = Person.all
    render json: @people
  end

  # GET /api/v1/people/:id
  def show
    # 直接复用set_person查询的实例变量，无需重复查库
    render json: @person
  end

  private
  def set_person
    @person = Person.find(params[:id])
  rescue ActiveRecord::RecordNotFound
    render json: { error: "人员记录不存在" }, status: :not_found
  end
end

• 检查父类ApiController：确认API模式下父类继承自ActionController::API而非ActionController::Base，移除所有会修改响应体的全局回调，避免干扰JSON渲染结果。
• 如果使用了第三方序列化库，补充nil值的兼容判断，避免序列化阶段返回空内容。

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