You need to enable JavaScript to run this app. Flask 如何原样透传内部POST请求获取的上游服务响应
优惠活动
大模型
产品
解决方案
定价
更多

Flask 如何原样透传内部POST请求获取的上游服务响应

Flask 实现上游响应全量无加工透传

此前尝试方案的报错根源

  • 直接返回requests的Response对象:Flask路由仅支持返回WSGI协议可识别的响应类型(字符串、字节流、原生Response对象、标准元组结构),第三方库的Response对象不在可解析范围内,会直接抛出类型错误
  • 对requests Response对象调用jsonify:jsonify的输入仅支持可JSON序列化的Python原生结构,requests Response是封装了请求、响应、会话信息的复杂对象,无法被JSON序列化,必然触发报错
  • 用json.dumps包裹响应内容构造Response:这种方式会把上游返回的原始内容做一次二次JSON转义,比如原本返回的字符串会被加上额外的引号、转义字符,完全破坏了原始内容结构,和透传需求相悖
  • 直接读取resp.raw.read()不开启流式模式:requests默认会将响应体自动解码、缓存到resp.content属性,此时raw流的位置已经被移动到文件末尾,直接读取会得到空内容,和预期不符

可直接复用的透传实现代码

import requests
from flask import Flask, request, Response

app = Flask(__name__)

@app.route('/stuff', methods=['POST'])
def get_stuff():
    # 转发请求参数给上游服务,对齐请求体、有效请求头
    upstream_resp = requests.post(
        "你的上游服务接口地址",
        data=request.get_data(),
        headers={
            k: v for k, v in request.headers
            if k.lower() not in ['host', 'content-length']
        },
        stream=True
    )
    # 过滤无法跨TCP连接透传的逐跳传输控制头
    skip_headers = {'content-encoding', 'content-length', 'transfer-encoding', 'connection'}
    passthrough_headers = [
        (header_name, header_value)
        for header_name, header_value in upstream_resp.raw.headers.items()
        if header_name.lower() not in skip_headers
    ]
    # 构造Flask原生Response对象,全量对齐上游的状态码、响应头、原始响应体
    return Response(
        upstream_resp.content,
        status=upstream_resp.status_code,
        headers=passthrough_headers
    )

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=9999)

实现核心要点

无加工透传的判定标准是:上游返回什么状态码、什么响应头、什么响应体,调用方就收到完全一致的内容,不存在二次加工、转码、序列化的操作。

  • 全程不修改上游返回的响应体内容,直接将原始二进制内容传入Response构造器,不要做json.dumps、jsonify这类会改变内容结构的操作
  • 必须过滤逐跳传输类的请求头、响应头,这类头是两次TCP连接之间的传输控制字段,跨连接透传会导致客户端解析时出现长度不匹配、连接异常等问题
  • 如果需要透传大体积文件、持续推送的流式内容,可以将upstream_resp.content替换为逐块读取的生成器函数,避免大体积内容占用过多服务端内存

内容的提问来源于stack exchange,提问作者Karric

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 12:36:01