flutter 使用dio发送本地https请求报错 - 教程

flutter: 测试异常: DioException [unknown]: null Error: HandshakeException: Handshake error in client (OS Error: CERTIFICATE_VERIFY_FAILED: unable to get local issuer certificate(../../third_party/boringssl/src/ssl/handshake.cc:393))

包括使用 Image.network 加载 https://192.168.31.164:9080/static/images/userimg.png 网络图片,也报错: ======== Exception caught by image resource service ================================================ The following HandshakeException was thrown resolving an image codec: Handshake error in client (OS Error: CERTIFICATE_VERIFY_FAILED: unable to get local issuer certificate(../../third_party/boringssl/src/ssl/handshake.cc:393))

dio报错解决办法

设置不进行https校验:

Image.network报错

本质是 Flutter 内置的网络请求(包括 Image.network 使用的 HttpClient)会验证 HTTPS 证书,而你本地服务用的是自签/不受信任的证书,所以握手失败。

Image.network 没法直接传 badCertificateCallback,所以要从 全局层面修改 HttpClient 的证书验证策略


✅ 方案 1:在编写环境全局忽略证书(最容易)

新建一个类继承 HttpOverrides,并在 main() 里覆盖:

import 'dart:io';
import 'package:flutter/material.dart';
class MyHttpOverrides extends HttpOverrides {
  @override
  HttpClient createHttpClient(SecurityContext? context) {
    return super.createHttpClient(context)
      ..badCertificateCallback = (X509Certificate cert, String host, int port) => true;
  }
}
void main() {
  HttpOverrides.global = MyHttpOverrides(); // 忽略所有证书验证
  runApp(const MyApp());
}

再次使用就能够了

posted @ 2025-10-23 16:51  yjbjingcha  阅读(1)  评论(0)    收藏  举报