无Flutter BuildContext的Dart类中导航处理方案咨询

你的核心问题是纯Dart实现的ApiClient需要触发Flutter的页面导航，但导航依赖BuildContext，而实例化ApiClient的类同样无法获取BuildContext。以下是几种可行的解决思路：

方案一：使用全局导航键（GlobalKey） #

这是最直接的方案，通过全局维护的导航键绕过BuildContext的限制：

1. 在Flutter顶层定义全局导航键
   在main.dart中定义全局的导航键，并关联到MaterialApp：

// 全局导航键
final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigatorKey, // 关联全局键
      initialRoute: '/home',
      routes: {
        '/home': (context) => const HomePage(),
        '/login': (context) => const LoginPage(),
      },
    );
  }
}

2. 修改ApiClient使用全局键导航
   调整ApiClient的构造参数，传入全局导航键，在需要跳转时直接使用该键触发导航：

class ApiClient {
  final Dio _dio = Dio();
  final TokenManager _tokenManager = TokenManager();
  final GlobalKey<NavigatorState> _navigatorKey;

  ApiClient(this._navigatorKey) {
    _dio.interceptors.add(InterceptorsWrapper(
      onRequest: (options, handler) async {
        options.headers['Authorization'] =
            'Bearer ${await _tokenManager.getAccessToken()}';
        return handler.next(options);
      },
      onError: (DioException e, handler) async {
        if (e.response?.statusCode == 401) {
          await refreshTokenAndRetryRequest(e, handler);
        }
        return handler.next(e);
      },
    ));
  }

  Future<void> refreshTokenAndRetryRequest(DioException e,
      ErrorInterceptorHandler handler) async {
    try {
      String? refreshToken = await _tokenManager.getRefreshToken();

      if (refreshToken != null) {
        Map<String, dynamic> newTokens =
            await refreshAccessTokenFromServer(refreshToken);

        await _tokenManager.setTokens(
            newTokens['accessToken'], newTokens['refreshToken']);

        e.requestOptions.headers['Authorization'] =
            'Bearer ${await _tokenManager.getAccessToken()}';
        return handler.resolve(await _dio.request(e.requestOptions.path!));
      } else {
        await _tokenManager.deleteTokens();
        // 使用全局导航键跳转登录页
        _navigatorKey.currentState?.pushReplacementNamed('/login');
      }
    } catch (refreshError) {
      throw Exception(
          'Failed to refresh token and retry request: $refreshError');
    }
  }
}

3. 实例化ApiClient
   在任何地方（包括纯Dart类）实例化ApiClient时，直接传入全局的navigatorKey即可：

final apiClient = ApiClient(navigatorKey);

方案二：通过状态管理通知UI层导航 #

这种方案遵循关注点分离原则，ApiClient只负责触发"需要登录"的状态变化，由UI层监听状态并执行导航：

1. 创建Auth状态类
   使用状态管理库（比如Provider）定义一个Auth状态类，用于传递未授权状态：

import 'package:flutter/foundation.dart';

class AuthState extends ChangeNotifier {
  bool _needLogin = false;

  bool get needLogin => _needLogin;

  void triggerLogin() {
    _needLogin = true;
    notifyListeners();
  }

  void resetLoginState() {
    _needLogin = false;
    notifyListeners();
  }
}

2. ApiClient依赖AuthState
   ApiClient不再直接处理导航，而是触发状态变化：

class ApiClient {
  final Dio _dio = Dio();
  final TokenManager _tokenManager = TokenManager();
  final AuthState _authState;

  ApiClient(this._authState) {
    // 拦截器代码同前，仅修改跳转逻辑
  }

  Future<void> refreshTokenAndRetryRequest(...) async {
    // ...其他代码
    else {
      await _tokenManager.deleteTokens();
      // 触发需要登录的状态
      _authState.triggerLogin();
    }
  }
}

3. UI层监听状态并导航
   在全局的父Widget（比如HomePage）中监听AuthState，当状态变化时执行导航：

import 'package:flutter/material.dart';
import 'package:provider/provider.dart';

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    final authState = Provider.of<AuthState>(context);
    // 用addPostFrameCallback避免BuildContext未就绪的问题
    if (authState.needLogin) {
      WidgetsBinding.instance.addPostFrameCallback((_) {
        Navigator.pushReplacementNamed(context, '/login');
        authState.resetLoginState();
      });
    }
    return const Scaffold(
      body: Center(child: Text('Home Page')),
    );
  }
}

4. 注册状态管理
   在main.dart中注册AuthState：

void main() {
  runApp(
    ChangeNotifierProvider(
      create: (context) => AuthState(),
      child: const MyApp(),
    ),
  );
}

方案三：封装导航服务类 #

将导航逻辑封装成独立的服务类，ApiClient依赖该服务而非直接依赖Flutter导航：

1. 创建导航服务类

import 'package:flutter/material.dart';

class NavigationService {
  final GlobalKey<NavigatorState> _navigatorKey = GlobalKey<NavigatorState>();

  GlobalKey<NavigatorState> get navigatorKey => _navigatorKey;

  void navigateToLogin() {
    _navigatorKey.currentState?.pushReplacementNamed('/login');
  }
}

2. 关联导航服务到MaterialApp

final NavigationService navigationService = NavigationService();

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navigationService.navigatorKey,
      routes: {
        '/home': (context) => const HomePage(),
        '/login': (context) => const LoginPage(),
      },
    );
  }
}

3. ApiClient依赖导航服务

class ApiClient {
  final Dio _dio = Dio();
  final TokenManager _tokenManager = TokenManager();
  final NavigationService _navigationService;

  ApiClient(this._navigationService) {
    // 拦截器代码同前
  }

  Future<void> refreshTokenAndRetryRequest(...) async {
    // ...其他代码
    else {
      await _tokenManager.deleteTokens();
      _navigationService.navigateToLogin();
    }
  }
}

4. 实例化ApiClient

final apiClient = ApiClient(navigationService);

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