Flutter中Image.network调用抛出HandshakeException问题求助

刚接触Flutter没几天就碰到这个问题确实挺头疼的，不过别担心，这个CERTIFICATE_VERIFY_FAILED的错误在开发中很常见，我给你几个实用的解决思路：

1. 先确认服务器证书的合法性 #

这个错误最常见的原因是服务器使用的证书不被设备信任：

• 如果是线上正式服务器，确保证书是由权威CA机构（比如Let’s Encrypt、DigiCert等）签发的，且没有过期、域名匹配正确。
• 如果是本地/测试服务器，大概率用的是自签名证书，这种证书默认不会被系统信任，需要针对性处理。

2. 测试环境临时绕过证书验证（仅限开发调试！） #

如果你只是在开发阶段调试，不想折腾证书，可以临时让Flutter信任所有证书，但绝对不能在生产环境用这个方法，会带来严重的安全风险。

实现方式是自定义HttpOverrides：

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

// 在main函数中设置全局覆盖
void main() {
  HttpOverrides.global = MyHttpOverrides();
  runApp(const MyApp());
}

这段代码会让所有HTTP请求跳过证书验证，包括Image.network()的请求。

3. 安全导入自签名证书（适合测试/内部应用） #

如果你的测试服务器用了自签证书，又想保证一定的安全性，可以把证书文件打包到应用中，让HttpClient信任这个特定的证书：

步骤1：准备证书文件 #

把你的自签证书（比如server_cert.pem）放到项目的assets文件夹下，然后在pubspec.yaml中声明资源：

flutter:
  assets:
    - assets/server_cert.pem

步骤2：创建信任该证书的HttpClient #

import 'dart:io';
import 'dart:typed_data';
import 'package:flutter/services.dart';

// 加载证书并创建SecurityContext
Future<SecurityContext> _getTrustedContext() async {
  final ByteData certData = await rootBundle.load('assets/server_cert.pem');
  final SecurityContext context = SecurityContext.defaultContext;
  context.setTrustedCertificatesBytes(certData.buffer.asUint8List());
  return context;
}

// 使用示例：用自定义HttpClient加载图片
Future<void> loadImage() async {
  final HttpClient client = HttpClient(context: await _getTrustedContext());
  final HttpClientRequest request = await client.getUrl(Uri.parse('你的图片URL'));
  final HttpClientResponse response = await request.close();
  // 后续可以把response转成ImageProvider
}

如果你觉得直接用HttpClient麻烦，也可以用cached_network_image这类第三方库，它支持传入自定义的HttpClient，用起来更方便。

4. 检查设备系统时间 #

这个容易被忽略：如果设备的系统时间和当前实际时间偏差太大（比如早了几个月或者晚了几年），会导致证书的有效期验证失败。先确认一下设备时间是不是正确的，说不定问题就出在这！

内容的提问来源于stack exchange，提问作者JokingWolf