Flutter中API调用最优方案：Dio与Http包该如何选择？

一、Dio 和 Http 哪个更适合API调用？ #

直接给结论：新手优先选Dio，理由如下：

• Http包：Flutter官方提供的基础库，轻量无依赖，但功能简陋——请求参数编码、响应解析、超时处理、错误捕获这些都得手动写，代码冗余且容易出错，只适合极简单的单次请求场景。
• Dio：第三方开源HTTP库，自带请求/响应拦截器、全局配置、自动JSON解析、超时设置、Cookie管理、文件上传下载等全套功能，代码简洁易维护，扩展性强，中大型项目或需要复杂API交互的场景完全适配，新手学习成本也低。

二、更优的API服务实现方式（针对你的代码优化） #

你的单例仓库思路没问题，但可以从这几个点优化：

1. 统一错误处理与异常捕获 #

你当前代码里多个状态码分支重复解析逻辑，还没处理请求过程中的异常（比如解析失败、超时），可以合并分支+全局捕获异常，避免程序崩溃同时让错误状态更清晰。

2. 抽离网络层配置 #

把网络客户端（比如Dio实例）的全局配置（baseUrl、超时、拦截器）抽出来单独管理，不要在每个仓库里重复初始化，减少冗余。

3. 简化单例写法 #

Flutter里更简洁的单例实现方式：

class CreateAccountRepository {
  CreateAccountRepository._();
  static late final CreateAccountRepository instance = CreateAccountRepository._();
  factory CreateAccountRepository() => instance;
}

4. 避免硬编码与空值风险 #

比如location可能为空，直接split会报错，要加空值判断；状态码可以封装成常量提升可读性。

三、优化后的示例代码 #

class CreateAccountRepository {
  CreateAccountRepository._();
  static late final CreateAccountRepository instance = CreateAccountRepository._();
  factory CreateAccountRepository() => instance;

  // 全局配置Dio实例，抽离到单独文件更优
  final Dio _dio = Dio(BaseOptions(
    baseUrl: AppUrl.baseUrl,
    connectTimeout: const Duration(seconds: 10),
    receiveTimeout: const Duration(seconds: 10),
  ));

  Future<CreateAccountResponse> userRegistration(AccountCreateRequest requestParams) async {
    try {
      bool isNetworkAvail = await NetworkCheck().check();
      if (!isNetworkAvail) {
        return CreateAccountResponse(message: AppStrings.ERROR_INTERNET_CONNECTION);
      }

      final response = await _dio.post(
        AppUrl.pathRegister,
        data: requestParams.toJson(),
        options: Options(headers: headerContentTypeAndAccept),
      );

      if (response.statusCode == HttpStatus.ok) {
        String location = response.headers['location'] ?? '';
        if (location.isNotEmpty) {
          String userId = location.split("/").last;
          CreateAccountResponse createAccountResponse = CreateAccountResponse.fromJson(response.data);
          createAccountResponse.isSuccess = true;
          createAccountResponse.userId = int.tryParse(userId) ?? 0;
          return createAccountResponse;
        }
        return CreateAccountResponse(message: AppStrings.ERROR_INVALID_RESPONSE);
      } else {
        // 统一处理非200状态码的业务错误
        return CreateAccountResponse.fromJson(response.data);
      }
    } on DioException catch (e) {
      // 处理Dio专属异常：超时、网络断开等
      String errorMessage = AppStrings.ERROR_NETWORK_REQUEST_FAILED;
      if (e.type == DioExceptionType.connectionTimeout) {
        errorMessage = AppStrings.ERROR_REQUEST_TIMEOUT;
      } else if (e.type == DioExceptionType.badResponse && e.response?.data != null) {
        return CreateAccountResponse.fromJson(e.response!.data);
      }
      return CreateAccountResponse(message: errorMessage);
    } catch (e) {
      // 兜底处理未知异常
      return CreateAccountResponse(message: AppStrings.ERROR_UNKNOWN);
    }
  }
}

额外实用建议 #

• 用Repository模式分层：把网络请求、本地缓存逻辑都封装在仓库层，上层ViewModel只调用仓库方法，解耦业务与数据层。
• 加全局拦截器：请求拦截器统一加token、打印日志；响应拦截器统一处理token过期、全局错误码。
• 复杂场景用Retrofit：通过注解生成请求代码，进一步简化API调用逻辑。

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