Flask RESTful POST请求无效JSON处理：返回友好错误提示

这个问题我太熟悉了！Flask默认处理带重复键的无效JSON时，要么默默忽略重复键（保留最后一个），要么在调试模式下直接抛出带Werkzeug调试器的HTML页面，完全不符合API返回友好提示的需求。而且你遇到的TypeError大概率是因为返回格式没处理好，咱们一步步来解决：

1. 基础方案：在视图内捕获解析错误并检测重复键 #

首先，我们要在视图函数里覆盖JSON解析的全流程——不仅要捕获解析失败的情况，还要主动检测重复键（因为标准json.loads()默认会保留最后一个重复键，不会报错）。

修改你的视图代码如下：

from flask import request, jsonify
from flask_restful import Resource, abort
import json
from collections import OrderedDict

class MyView(Resource):
    def post(self):
        try:
            # 先获取原始JSON字符串，用于检测重复键
            raw_json_str = request.get_data().decode('utf-8')
            
            # 自定义解析器钩子，检测重复键
            def check_duplicate_keys(pairs):
                seen_keys = set()
                for key, value in pairs:
                    if key in seen_keys:
                        raise ValueError(f"JSON包含重复键: {key}")
                    seen_keys.add(key)
                    yield (key, value)
            
            # 用自定义钩子解析JSON，捕获格式错误和重复键错误
            try:
                signup_data = json.loads(raw_json_str, object_pairs_hook=check_duplicate_keys)
            except json.JSONDecodeError:
                abort(400, message="JSON格式无效")
            except ValueError as e:
                abort(400, message=str(e))
            
            # 检查必填字段是否存在
            if 'country_code' not in signup_data:
                abort(400, message="缺少必填字段: country_code")
            country_code = signup_data['country_code']
            
            # 这里写你的业务逻辑...
            
            # 返回标准JSON响应，避免TypeError
            return jsonify({
                "status": "success",
                "message": "处理成功",
                "country_code": country_code
            })
        
        except Exception as e:
            # 兜底处理其他未预料的异常
            abort(500, message="服务器内部错误")

2. 进阶方案：全局错误处理（更优雅） #

如果你的API有多个视图，不想每个都写重复的错误逻辑，可以用Flask RESTful的全局错误处理器，统一处理JSON相关的异常：

from flask import jsonify
from flask_restful import Api
from werkzeug.exceptions import BadRequest

api = Api(app)

# 统一处理JSON解析失败的情况
@api.errorhandler(BadRequest)
def handle_bad_request_error(e):
    return jsonify({"error": "JSON格式无效"}), 400

# 统一处理自定义的重复键异常
@api.errorhandler(ValueError)
def handle_duplicate_key_error(e):
    return jsonify({"error": str(e)}), 400

# 统一处理服务器内部错误
@api.errorhandler(500)
def handle_internal_error(e):
    return jsonify({"error": "服务器内部错误"}), 500

3. 关键注意点：避免TypeError #

你遇到的TypeError: <Response 29 bytes [200 OK]> is not JSON serializable错误，本质是因为Flask RESTful的视图函数期望返回可JSON序列化的对象（比如字典），而不是直接返回Response对象。用jsonify()包装返回结果，或者直接返回字典，就能避免这个问题。

另外，生产环境一定要关闭调试模式：

if __name__ == '__main__':
    app.run(debug=False)  # 禁止在生产环境开启debug

调试模式会暴露敏感代码信息，而且会返回带调试器的HTML页面，完全不适合对外的API服务。

内容的提问来源于stack exchange，提问作者R.Roshan