You need to enable JavaScript to run this app. Flutter HTTP POST请求报ClientException错误,dio无效,Postman同请求正常
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 01:45:10