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
相关产品推荐
相关产品推荐

