Flutter基于Bloc模式带Token调用API的优雅实现方案咨询

针对你遇到的问题，这里提供几个Bloc生态下简洁的实现方式，避免给所有API客户端注入authentication_repository的杂乱感：

1. 全局HTTP拦截器（最推荐） #

核心思路是用一个带身份验证拦截器的通用HTTP客户端，所有API客户端复用这个客户端，自动处理Token的注入：

• 第一步：在authentication_repository中暴露获取Token的方法，比如：

  class AuthenticationRepository {
    // ...其他登录、登出逻辑
    Future<String?> getToken() async {
      // 从本地存储（比如SharedPreferences、Hive）获取Token
      return _localStorage.get('auth_token');
    }
  }
  

• 第二步：创建全局HTTP客户端并添加拦截器（以Dio为例）：

  class AuthInterceptor extends Interceptor {
    final AuthenticationRepository _authRepo;
  
    AuthInterceptor(this._authRepo);
  
    @override
    void onRequest(RequestOptions options, RequestInterceptorHandler handler) async {
      final token = await _authRepo.getToken();
      if (token != null) {
        options.headers['Authorization'] = 'Bearer $token';
      }
      handler.next(options);
    }
  }
  
  // 初始化带拦截器的Dio实例
  final dio = Dio()..interceptors.add(AuthInterceptor(AuthenticationRepository()));
  

• 第三步：所有other_apis下的API客户端直接使用这个全局Dio实例，无需关心Token的来源，请求时拦截器会自动注入Token到请求头。

这种方式的优势是API客户端和authentication_repository完全解耦，代码整洁度最高。

2. 独立Token Provider服务 #

抽离一个专门的token_provider包，作为Token的唯一管理入口：

• 创建packages/token_provider，提供TokenProvider类：

  class TokenProvider {
    Future<String?> getToken() async { /* 从本地取Token */ }
    Future<void> saveToken(String token) async { /* 存Token */ }
    Future<void> clearToken() async { /* 清Token */ }
  }
  

• authentication_repository登录成功后调用tokenProvider.saveToken(token)
• 所有API客户端注入TokenProvider，请求时调用getToken()添加到请求头

这种方式把Token的管理从authentication_repository中分离出来，让各模块的依赖关系更清晰，避免API客户端直接依赖认证模块。

3. 依赖注入（DI）自动注入 #

如果你的项目使用GetIt、Injectable这类DI工具，可以通过DI的自动注入能力简化依赖传递：

• 用Injectable标记AuthenticationRepository为可注入：

  @Injectable()
  class AuthenticationRepository {}
  

• 在API客户端的实现类中，让DI自动注入AuthenticationRepository，无需手动传参：

  @Injectable(as: UserApiClient)
  class UserApiClientImpl implements UserApiClient {
    final AuthenticationRepository _authRepo;
  
    UserApiClientImpl(this._authRepo); // DI自动注入
  
    Future<User> getUserInfo() async {
      final token = await _authRepo.getToken();
      // 携带Token发起请求
    }
  }
  

这种方式虽然还是依赖AuthenticationRepository，但DI会自动处理实例的传递，代码中不会出现到处手动传参的杂乱情况。

内容的提问来源于stack exchange，提问作者kk-at-cbx