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

1024小神2025-09-26 19:20

大家好，我是1024小神，技术群 / 私活群 / 股票群或交朋友都可以私信我。如果你觉得本文有用，一键三连 (点赞、评论、关注)，就是对我最大的支持~

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() 里覆盖：

Dart 复制代码

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());
}

再次使用就可以了

大家好，我是1024小神，技术群 / 私活群 / 股票群或交朋友都可以私信我。如果你觉得本文有用，一键三连 (点赞、评论、关注)，就是对我最大的支持~