使用Dio发送multipart/form-data格式POST请求报400错误
400报错的核心根因(原代码硬伤)
- 请求数据的JSON结构存在语法错误:原代码中
data字段的嵌套写法缺失冒号、大括号配对混乱,构造出的请求体完全不符合接口要求的格式,后端无法解析直接返回400。 - Content-Type与数据格式不匹配:当前直接传Dart Map结构的请求体,却手动指定
multipart/form-data作为Content-Type,后端无法正确解析请求内容。 - 错误信息被完全吞掉:原代码的catch块只做简单print,没有捕获DioError中400状态对应的后端响应体——通常400错误后端会明确返回字段格式错误、字段缺失的具体提示,直接忽略该信息会导致排查完全无方向。
- 响应解析逻辑错误:原代码尝试从
response.statusMessage解析JSON数据,该字段是HTTP状态码的文本描述(如“OK”),并非后端返回的业务数据,属于完全的逻辑错位。 - 无效参数残留:方法入参
formData从未被使用,属于无意义的占位代码。
修正实现
调整以下核心逻辑即可解决问题:
- 捋顺请求数据的JSON结构,按照后端接口要求的字段层级构造合法的请求体
- 匹配对应的数据格式Content-Type:传JSON结构就用
application/json,不要强行指定multipart - 补全错误捕获逻辑,把400状态下后端返回的具体错误信息打印出来,快速定位字段问题
- 修正响应数据的解析来源,从
response.data中取业务返回值
修正后的可运行代码如下:
class AddQuestion { addApiQuestion(String quizId) async { final String url = apiServer + 'quizzes/exam/$quizId/questions/add/'; try { var response = await Dio().post( url, // 按后端要求调整数据结构,此处为标准JSON根节点结构示例 data: { "text": "Compare between Bubble sort and merge sort", "helping_text": "Explain", "score": 10, "status": 1, "question_type": 1, "options": [ { "text": "Q_4 answer_1 exam_7", "is_correct": false, "status": 1 }, { "text": "Q_4 answer_2 exam_7", "is_correct": false, "status": 1 }, { "text": "Q_4 answer_3 exam_7", "is_correct": true, "status": 1 } ] }, options: Options( headers: { 'accept': '*/*', 'Authorization': 'Bearer ${AppHelper().getToken().access}', // 匹配JSON数据的Content-Type 'contentType': 'application/json', }, ), ); if (response.statusCode == 200 || response.statusCode == 201 || response.statusCode == 302) { // 从response.data解析业务数据 return json.decode(response.data.toString()); } else { return null; } } on DioError catch (e) { // 打印400状态下的后端返回详情,可直接定位具体字段错误 if (e.response != null) { print('请求错误状态码:${e.response?.statusCode}'); print('后端返回错误详情:${e.response?.data}'); } return null; } catch (e) { print('未知错误:$e'); return null; } } }
额外提示:如果后端接口确实要求以multipart/form-data格式接收数据,不能直接把嵌套Map作为请求体传入,需要构造
FormData对象,将嵌套结构的options数组按照表单字段规则(如options[0][text]、options[0][is_correct])拆分为可识别的表单键值对,否则依然会触发400错误。
内容的提问来源于stack exchange,提问作者Mahmoud Adel
相关产品推荐
相关产品推荐

