You need to enable JavaScript to run this app. 如何在Flutter中绕过SSL证书验证以解决自签名证书握手报错?
优惠活动
大模型
产品
解决方案
定价
更多

如何在Flutter中绕过SSL证书验证以解决自签名证书握手报错?

Flutter 自签名证书导致SSL握手校验失败的解决方案

报错核心触发原因:SSL握手阶段,客户端对服务端返回的自签名证书做信任链校验时,发现证书不在系统预置的受信CA列表中,直接抛出CERTIFICATE_VERIFY_FAILED: self signed certificate错误,中断请求流程。可根据实际使用场景选择对应实现方案:

开发调试阶段:临时全量跳过证书校验

该方案仅适用于本地开发、内网联调场景,严禁打包进入正式发布版本,否则会面临请求被中间人劫持、数据泄露的高安全风险

原生HttpClient实现

import 'dart:io';

HttpClient client = HttpClient();
// 所有证书校验请求直接放行
client.badCertificateCallback = (X509Certificate cert, String host, int port) => true;

适配Dio网络库

import 'package:dio/dio.dart';

final dio = Dio();
dio.httpClientAdapter = IOHttpClientAdapter(
  createHttpClient: () {
    final HttpClient client = HttpClient();
    client.badCertificateCallback = (cert, host, port) => true;
    return client;
  },
);

生产环境推荐:定向信任指定自签名证书

该方案不会全局跳过证书校验,仅对开发者指定的自签名证书放行,其余所有请求依然走系统默认的严格证书校验逻辑,无额外安全风险。
实现步骤:

  • 将服务端的自签名证书文件(.crt/.pem格式)放入项目assets/certs/目录,在pubspec.yaml中完成资产路径声明
  • 自定义校验逻辑,仅当请求的目标主机匹配、且服务端返回的证书内容与内置证书一致时,才跳过校验
    示例代码:
import 'dart:io';
import 'dart:convert';
import 'package:flutter/services.dart' show PlatformAssetBundle;
import 'package:crypto/crypto.dart';

Future<void> configureTrustedCertificate() async {
  // 读取项目内置的自签名证书内容,计算哈希值作为信任校验依据
  final certData = await PlatformAssetBundle().loadAsset('assets/certs/your_server_cert.crt');
  final trustedCertHash = sha256.convert(certData.buffer.asUint8List()).toString();

  final client = HttpClient();
  client.badCertificateCallback = (cert, host, port) {
    // 仅对指定测试服务器域名的请求做定向校验
    if (host == '你的测试服务器域名或IP') {
      final currentCertHash = sha256.convert(utf8.encode(cert.pem)).toString();
      // 证书哈希匹配则放行,其余情况正常触发校验失败
      return currentCertHash == trustedCertHash;
    }
    return false;
  };
}

常见踩坑点

  • Flutter Web端不支持通过代码自定义证书校验逻辑,证书校验由浏览器内核强制控制,需在测试设备的系统级证书库中导入对应自签名证书才能完成正常握手
  • Android 7.0及以上版本默认不信任用户手动安装的CA证书,若通过系统证书链路实现信任,需在network_security_config.xml中定向声明信任指定域名的自签名证书,禁止全局开放用户证书信任
  • iOS端需要在Info.plist的NSAppTransportSecurity配置中添加对应自签名服务器的访问例外,否则即便代码层放开校验,系统网络栈仍会直接拦截非合规的ATS请求

内容的提问来源于stack exchange,提问作者Haroon Ahmed

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.20 04:15:04