如何基于OpenAPI YAML文件在Flask服务器验证请求体

云上老周

2026-7-23

基于OpenAPI规范自动验证Flask请求体的方案

当然有这类Python库，下面介绍两个最常用的方案，可直接基于你的OpenAPI YAML文件自动完成请求体验证，不符合规则时自动返回400 Bad Request：

1. Connexion

Connexion是专门基于OpenAPI/Swagger规范构建Web服务的框架，可直接集成Flask，自动处理请求验证、路由映射等工作。

操作步骤：

安装依赖：

pip install connexion[flask]

修改Flask服务代码，通过Connexion加载OpenAPI规范：

#!/usr/bin/python3
import connexion

app = connexion.FlaskApp(__name__)
# 加载你的OpenAPI YAML文件（假设文件名为openapi.yaml）
app.add_api('openapi.yaml')

# 原逻辑保持不变，Connexion会自动匹配OpenAPI中定义的路径
def read_flag(body):
    return {"flag": body.get("flag")}

if __name__ == "__main__":
    app.run(port=345)

说明：

Connexion会自动解析OpenAPI YAML中的请求体Schema，请求到达/test接口时，自动校验flag字段的必填性、长度、格式规则。若请求不符合规则（比如flag长度小于6、不是纯数字字符串），会自动返回400 Bad Request并附带详细错误信息。

2. flask-openapi3

flask-openapi3是专为Flask打造的OpenAPI 3.x集成库，语法贴近原生Flask，同时支持自动请求验证。

操作步骤：

安装依赖：

pip install flask-openapi3

修改Flask服务代码，加载OpenAPI规范并绑定路由：

#!/usr/bin/python3
from flask_openapi3 import OpenAPI, RequestBody

app = OpenAPI(__name__, title="Test Title", version="1.0")

# 加载本地OpenAPI YAML文件（假设名为openapi.yaml）
app.spec_from_file('openapi.yaml')

@app.route("/test", methods=["POST"])
def read_flag(body: RequestBody):
    return {"flag": body.data.get("flag")}

if __name__ == "__main__":
    app.run(port=345)