You need to enable JavaScript to run this app. 使用dio 3.0.10发起POST请求时出现CERTIFICATE_VERIFY_FAILED错误
优惠活动
大模型
产品
解决方案
定价
更多

使用dio 3.0.10发起POST请求时出现CERTIFICATE_VERIFY_FAILED错误

Dio 3.0.10 发起POST请求报CERTIFICATE_VERIFY_FAILED错误的解决方法

该报错是客户端在TLS握手阶段,对服务端返回的SSL证书校验不通过触发的,常见诱因包括服务端使用自签名证书、返回的证书链不完整、证书绑定域名与实际请求的host不匹配。

开发调试阶段临时解决方案

该配置仅可用于本地开发调试,绝对不能在生产环境上线,否则会存在中间人攻击的安全风险
针对Dio 3.0.10的版本特性,需要在初始化Dio实例时,给默认的HTTP适配器设置证书校验放行规则,示例配置代码如下:

// 初始化Dio实例的位置添加以下配置
final _dio = Dio(BaseOptions(
  // 保留你原有的baseUrl、超时时间、请求头等基础配置
));

// 3.0.10版本专属的适配器配置逻辑
(_dio.httpClientAdapter as DefaultHttpClientAdapter).onHttpClientCreate = (client) {
  // 自定义证书校验回调,调试阶段直接返回true放行所有校验异常
  client.badCertificateCallback = (X509Certificate cert, String host, int port) {
    return true;
  };
};

额外平台配置注意点

如果是Android 9.0及以上版本运行应用,除了SSL证书配置外,如果你的请求是明文HTTP地址,还需要在android/app/src/main/AndroidManifest.xml的<application>标签中添加配置:android:usesCleartextTraffic="true",否则系统会默认拦截所有明文HTTP请求。

生产环境安全解决方案

生产环境禁止全局放行所有证书校验,可通过打包服务端证书到应用本地的方式,仅信任指定的合法证书,操作步骤为:

  • 将服务端的公钥证书(.pem/.crt格式)放到应用的assets资源目录,在pubspec.yaml中声明该资源路径
  • 在badCertificateCallback中,将握手时拿到的服务端证书和本地打包的合法证书做比对,仅匹配通过时返回true,其他场景依然走默认的证书校验逻辑

现有代码的小问题优化

你代码中获取响应Cookie的逻辑没有做空判断,如果服务端某次响应没有返回set-cookie头,会直接抛出空指针异常,建议修改为:

// 原Cookie获取逻辑的安全优化
final cookies = response.headers.map['set-cookie'];
if (cookies != null && cookies.isNotEmpty && cookies.length == 2) {
  final authToken = cookies[1].split(';')[0];
  aToken = authToken;
  print(authToken);
}

内容的提问来源于stack exchange,提问作者Farhan Fida

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.23 13:57:00