Rails如何将NodeJS API返回的二进制Zip数据提供给浏览器下载

我之前处理过几乎一模一样的场景，直接转发二进制数据是最高效的方案（不用额外写磁盘），当然也支持先存临时文件再发送的方式，下面给你详细的实现步骤和代码示例：

方案一：直接转发二进制数据（推荐） #

这个方案不需要在Rails服务器上生成临时文件，直接把Node API返回的二进制数据原封不动传给浏览器，性能更好。

实现代码（用HTTParty为例） #

def download_zip
  # 替换成你的Node API地址
  node_api_endpoint = "http://your-node-api-server/pack-zip"
  
  # 调用Node API，注意设置format: :binary保留二进制数据
  api_response = HTTParty.post(
    node_api_endpoint,
    body: { file_params: params[:target_files] }, # 传给Node的文件参数
    format: :binary # 关键：禁止HTTParty解析响应，保留原始二进制
  )

  if api_response.success?
    # 设置正确的响应头，告诉浏览器这是要下载的Zip文件
    headers['Content-Type'] = 'application/zip'
    headers['Content-Disposition'] = 'attachment; filename="user_files.zip"'
    # 可选：如果Node API返回了Content-Length，直接复用
    headers['Content-Length'] = api_response.headers['Content-Length'] if api_response.headers['Content-Length']

    # 直接发送二进制数据
    send_data api_response.body, type: 'application/zip', disposition: 'attachment'
  else
    # 处理API调用失败的情况
    render plain: "Failed to generate zip file", status: :bad_gateway
  end
end

如果你的Node API返回的是Base64编码的Zip数据，需要先解码再发送：

decoded_data = Base64.decode64(api_response.body)
send_data decoded_data, type: 'application/zip', disposition: 'attachment'

方案二：先存临时文件再发送 #

如果需要对Zip文件做额外处理（比如校验、备份），可以先把二进制数据写入临时文件，再通过send_file发送：

实现代码 #

def download_zip_via_temp_file
  node_api_endpoint = "http://your-node-api-server/pack-zip"
  api_response = HTTParty.post(
    node_api_endpoint,
    body: { file_params: params[:target_files] },
    format: :binary
  )

  if api_response.success?
    # 创建临时Zip文件，存在Rails的tmp目录下
    temp_zip = Tempfile.new(['user_download', '.zip'], Rails.root.join('tmp'))
    temp_zip.binmode # 必须设置二进制模式，避免编码问题
    temp_zip.write(api_response.body)
    temp_zip.close

    # 发送临时文件给浏览器
    send_file temp_zip.path,
              filename: "user_files.zip",
              type: "application/zip",
              disposition: "attachment"

    # 请求结束后自动删除临时文件，避免磁盘占用
    at_exit { temp_zip.unlink }
  else
    render plain: "Failed to generate zip file", status: :bad_gateway
  end
end

关键注意事项 #

• 确保Node API返回的是原始二进制Zip数据，不要被自动转成JSON或者Base64（除非你在Rails里做对应解码）
• Content-Disposition头一定要设置成attachment，否则浏览器可能会直接在页面里打开Zip而不是触发下载
• 如果用Net::HTTP替代HTTParty，核心逻辑一样：拿到response.body的二进制数据，设置响应头后发送

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