Flutter HTTP POST请求报ClientException错误,dio无效,Postman同请求正常
问题现象
调用HTTP POST请求时抛出客户端异常 ClientException (HTTP解析失败:标记位置预期值13,实际收到值67)。
尝试发起常规HTTP请求始终复现该错误,即便切换dio网络库开发仍未解决。
附错误截图。
本次调用的REST API由客户提供,使用Postman发起完全相同的请求可正常运行。
复现代码
try { dynamic response = await http.post( "https://api/signup", headers: <String, String>{ 'Content-Type': 'application/json; charset=UTF-8', }, body: jsonEncode({}), ); return response; } catch (e) { print(e); }
环境检查输出
[√] Flutter(稳定渠道,1.22.4版本,运行于微软Windows系统 [版本10.0.19041.630],系统语言 pt-BR) [√] Android开发工具链(Android SDK 30.0.2版本) [!] Android Studio(3.4版本) X 未安装Dart插件,该插件提供Dart语言专属开发能力 X 无法识别内置的Java版本 [!] Android Studio(4.1.0版本) X 未安装Flutter插件,该插件提供Flutter专属开发能力 X 未安装Dart插件,该插件提供Dart语言专属开发能力 [√] VS Code(64位版本,1.51.1版本) [!] 已连接设备 ! 无可用设备 ! 环境检查发现3类问题
根因定位与解决方案
该报错是Dart IO层内置HTTP解析器的协议校验失败,本质是程序收到的网络响应完全不符合HTTP协议规范,而非业务代码逻辑或网络库选型问题。报错中两个数值的含义:解析器预期在响应流的固定位置读到回车符(ASCII值13,为HTTP协议规定的响应行分隔标记),但实际读到的是大写字母C(ASCII值67),说明收到的内容根本不是合法的HTTP响应包。
可按以下优先级排查解决:
- 检查请求URL是否为完整可解析的合法域名
示例代码中的请求地址https://api/signup为占位写法,未携带完整的域名后缀(如api.客户域名.com)。这类不完整地址会导致系统DNS解析失败,返回的非HTTP协议内容(如DNS错误提示、代理拦截文本)会直接触发解析报错。需替换为客户提供的完整、可公网解析的API地址后重试。 - 校验网络传输链路是否存在内容篡改
Postman请求正常说明API服务本身无异常,可排查本地网络是否开启了代理、VPN、防火墙拦截,或公司网关对HTTPS流量做了中间人解密篡改,导致返回的响应内容被替换为非HTTP协议的拦截提示(如“无法连接到目标服务”类的文本,首字符为C)。可切换手机热点直连外网后重试,排除链路篡改问题。 - 适配网络库的非标准响应处理
若使用dio库发起请求,可调整配置跳过非标准HTTP响应的严格校验,兼容部分不符合RFC规范的自定义API返回:BaseOptions( followRedirects: true, // 不强制校验响应状态码合法性 validateStatus: (status) => status != null && status < 500, receiveDataWhenStatusError: true, ) - 核对API的传输协议要求
确认客户提供的API是仅支持明文HTTP还是强制HTTPS。若API实际为HTTP协议,代码中使用HTTPS握手后传输的明文内容会直接被解析器识别为非法协议结构,触发标记位置不匹配报错。
内容的提问来源于stack exchange,提问作者Murilo Haas
相关产品推荐
相关产品推荐

