Flask接口返回JSON数据时报视图函数未返回有效响应错误如何解决

排查步骤 #

• 首先确认buscaIndicados函数是否添加了正确的Flask路由装饰器，比如@app.route('/xxx/<codigo>')，如果没有注册为路由视图函数，Flask会将其识别为普通函数，无法处理请求返回响应。
• 开启Flask调试模式（app.run(debug=True)，生产环境请关闭），访问接口时会返回详细的错误栈信息，可以直接定位到代码中断执行的具体位置。
• 检查函数执行过程中是否出现了未捕获的异常，导致没有走到最后的return语句：
  • 数据库连接环节：确认servidor、dataBase、usuario、senha这几个数据库连接参数是否正确，连接失败抛出异常会直接中断函数执行，不会走到return。
  • SQL语法风险：当前用f字符串拼接SQL非常危险，而且如果传入的codigo含有特殊字符（比如单引号）会导致SQL执行报错，中断流程。
  • 空查询边界问题：当查询结果为空时，cursor.description会返回None，此时row_headers = [x[0] for x in cursor.description]会抛出遍历None的异常，也会导致函数中断无返回。
• 确认是否在函数其他分支有return None的逻辑，若存在隐藏的分支判断没写return也会触发这个报错。

具体修复方案 #

1. 补全路由装饰器，根据业务需求设置正确的接口路径和请求方法，示例：

# 示例设置为GET请求，路径参数接收codigo
@app.route('/busca_indicados/<codigo>', methods=['GET'])
def buscaIndicados(codigo):
    # 原有业务逻辑

2. 增加异常捕获逻辑，替换不安全的SQL拼接方式，处理空查询的边界情况，修改后的完整代码示例：

import mysql.connector
from flask import jsonify

@app.route('/busca_indicados/<codigo>', methods=['GET'])
def buscaIndicados(codigo):
    list_data = []
    conn = None
    cursor = None
    try:
        # 用参数化查询代替f字符串拼接，避免SQL注入和语法错误
        query = "SELECT idCliente, codIndicacao, dataVencimento, status FROM clientes WHERE codIndicado = %s"
        conn = mysql.connector.connect(host=servidor,database=dataBase,user=usuario,password=senha)
        cursor = conn.cursor()
        # 参数化传递查询条件
        cursor.execute(query, (codigo,))
        # 先判断cursor.description是否存在，避免空查询报错
        if cursor.description:
            row_headers = [x[0] for x in cursor.description]
            resultado = cursor.fetchall()
            for result in resultado:
                list_data.append(dict(zip(row_headers, result)))
        return jsonify(result=list_data)
    except Exception as e:
        # 出错时也返回标准JSON格式的错误信息，避免函数无返回
        return jsonify(error=str(e)), 500
    finally:
        # 确保数据库连接和游标正常关闭
        if cursor:
            cursor.close()
        if conn:
            conn.close()

3. 如果要使用json.dumps代替jsonify，需要手动指定响应头和状态码，示例：

import json
from flask import make_response

# 替换return部分的代码为：
response = make_response(json.dumps({"result": list_data}), 200)
response.headers["Content-Type"] = "application/json"
return response

内容的提问来源于stack exchange，提问作者Maurício Morhy