Flask集成Flasgger异常：Swagger运行无结果，加responses报Fetch错误

核心排查与修复步骤 #

1. 确认Flasgger初始化正确性 #

必须确保Flasgger实例与Flask应用正确绑定，初始化代码不能出错：

from flask import Flask
from flasgger import Swagger

app = Flask(__name__)
swagger = Swagger(app)  # 关键：将Flask实例传入Swagger

2. 修正responses配置格式 #

Flasgger对YAML注释的语法要求严格，responses: 200:属于不完整配置，必须补充响应描述和结构，否则会触发解析错误：

@app.route('/iris/predict', methods=['POST'])
def iris_predict():
    """
    鸢尾花品种预测接口
    ---
    parameters:
      - name: sepal_length
        in: formData
        type: number
        required: true
        description: 花萼长度
      - name: sepal_width
        in: formData
        type: number
        required: true
        description: 花萼宽度
    responses:
      200:
        description: 成功返回预测结果
        schema:
          type: object
          properties:
            prediction:
              type: string
              description: 预测的鸢尾花品种
    """
    # 你的预测逻辑代码
    return {"prediction": "setosa"}

注意：YAML部分的缩进必须统一（建议用2个空格），冒号后必须加空格，语法错误会直接导致Swagger无法加载。

3. 匹配GET接口的参数配置 #

如果是GET接口，参数位置要设为query而非formData，否则Swagger无法识别参数：

@app.route('/iris/predict-get', methods=['GET'])
def iris_predict_get():
    """
    鸢尾花品种预测GET接口
    ---
    parameters:
      - name: petal_length
        in: query
        type: number
        required: true
        description: 花瓣长度
    responses:
      200:
        description: 成功返回预测结果
        schema:
          type: object
          properties:
            prediction:
              type: string
    """
    # 你的GET接口逻辑代码
    return {"prediction": "versicolor"}

4. 清除浏览器缓存或更换浏览器测试 #

浏览器缓存可能导致Swagger UI无法加载最新文档，按Ctrl+Shift+R强制刷新页面，或换Chrome/Firefox访问http://localhost:5000/apidocs/。

5. 确保版本兼容性 #

安装稳定版本的Flasgger，避免版本不兼容问题：

pip install flasgger==0.9.7.1

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