Flutter中API域名SSL过期时自动切换HTTP的实现方案咨询

核心思路 #

通过捕获HTTPS请求的SSL异常，动态切换API地址的协议类型，同时加入请求重试逻辑，避免因SSL问题导致应用启动卡死。

具体实现步骤 #

1. 改造BASE_URL的存储方式 #

将静态常量改为可修改的变量，方便后续切换协议：

// 初始默认使用HTTPS
String baseUrl = 'https://example.com';

2. 在网络请求工具中添加异常捕获与协议切换 #

以常用的Dio库为例，在全局拦截器中识别SSL相关错误并处理：

import 'package:dio/dio.dart';

class ApiClient {
  final Dio _dio = Dio();

  ApiClient() {
    _dio.options.baseUrl = baseUrl;
    // 添加错误拦截器处理SSL异常
    _dio.interceptors.add(InterceptorsWrapper(
      onError: (DioException error, ErrorInterceptorHandler handler) async {
        // 判断是否为SSL证书相关错误（覆盖多平台常见错误场景）
        bool isSslError = error.type == DioExceptionType.ssl ||
            error.message?.toLowerCase().contains('ssl') == true ||
            error.message?.toLowerCase().contains('certificate') == true;

        if (isSslError && baseUrl.startsWith('https://')) {
          // 切换为HTTP协议
          baseUrl = baseUrl.replaceFirst('https://', 'http://');
          _dio.options.baseUrl = baseUrl;
          // 重试当前失败的请求
          try {
            final retryResponse = await _dio.fetch(error.requestOptions);
            return handler.resolve(retryResponse);
          } catch (retryError) {
            return handler.reject(error);
          }
        }
        handler.reject(error);
      },
    ));
  }

  // 示例GET请求方法
  Future<Response> get(String endpoint) async {
    return await _dio.get(endpoint);
  }
}

3. 优化启动时的请求逻辑 #

如果应用启动阶段依赖API请求，需加入异常捕获避免阻塞启动流程：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  final apiClient = ApiClient();
  try {
    // 执行启动必需的初始化请求
    await apiClient.get('/app-init');
  } catch (e) {
    debugPrint('初始化请求触发SSL错误，已自动切换为HTTP: $e');
  }
  
  runApp(const MyApp());
}

4. 补充优化点 #

• 协议状态持久化：用SharedPreferences保存当前使用的协议，避免每次启动都触发SSL错误后才切换：

// 初始化时读取保存的协议
SharedPreferences prefs = await SharedPreferences.getInstance();
String savedProtocol = prefs.getString('api_protocol') ?? 'https';
baseUrl = '$savedProtocol://example.com';

// 切换协议时保存状态
await prefs.setString('api_protocol', 'http');

• 安全提示：HTTP传输为明文，仅作为临时应急方案，SSL证书续签完成后，需通过后台接口通知或版本更新切回HTTPS。
• 多平台兼容：不同平台的SSL错误提示存在差异，需实际测试覆盖iOS、Android的错误场景。

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