Flask-RESTful调用reqparse的parse_args()报JSON解码错误如何解决

报错根因 #

这个报错和你定义的float、str类型参数校验规则无关，是flask_restful在执行参数解析前，会默认尝试把请求体解析为JSON格式，当请求体为空、格式非法，或者请求头标记了JSON类型但实际没传JSON内容时，会直接抛出解码错误，根本不会走到后续的参数类型校验逻辑。

排查步骤 #

• 核对请求头Content-Type字段：如果参数是放在URL查询串、路径、form表单中传递，但请求头误写为application/json，框架会强制读取请求体做JSON解析，空请求体就会触发"char 0"解码错误。GET请求误带JSON类型请求头是最高发的场景，GET请求规范本身不携带请求体，绝大多数客户端发GET请求时请求体为空。
• 核对请求体实际内容：如果接口确实设计为接收JSON入参，检查请求体是否为空、是否带UTF-8 BOM头、是否存在非法JSON语法（比如单引号替代双引号、末尾冗余逗号、全角标点）。
• 核对参数定义是否指定取值位置：RequestParser.add_argument默认不限制参数取值位置，会按默认优先级扫描JSON请求体、form、URL参数等位置，只要触发JSON扫描逻辑，就会先尝试解析请求体JSON。

解决方法 #

1. 所有参数显式指定location属性，禁止框架自动猜测参数位置。如果你的参数全部通过URL查询串传递，参考如下写法：

from flask_restful import reqparse

path_params = reqparse.RequestParser()
# 字符串类型城市参数
path_params.add_argument('city', type=str, location='args', required=True)
# 批量添加浮点类型参数
float_arg_list = ['star_min', 'star_max', 'diary_max', 'diary_min', 'limit', 'offset']
for arg_name in float_arg_list:
    path_params.add_argument(arg_name, type=float, location='args')

# 执行参数解析
parsed_args = path_params.parse_args()

参数位置根据实际传参场景替换：form表单传参用location='form'，路径参数用location='path'，JSON请求体传参用location='json'。
2. 针对全量参数都在URL/路径上、不需要解析JSON请求体的接口，可以全局关闭严格JSON解析校验：

from flask import Flask

app = Flask(__name__)
app.config['RESTFUL_JSON'] = {'strict': False}

3. 调试阶段可以直接打印请求原始信息快速定位问题：

from flask import request
# 接口内打印请求基础信息
print(f"请求Content-Type: {request.content_type}")
print(f"原始请求体内容: {repr(request.get_data(as_text=True))}")

踩坑提示：如果用Postman、Apifox这类接口测试工具，注意检查工具是否自动给请求加了多余的Content-Type: application/json头，很多时候工具默认配置会给所有请求带这个头，哪怕你根本没填请求体内容。

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