基于未授权API响应的登出方案合理性及报错咨询

首先明确：你想在API层统一处理401未授权响应、自动触发登出，避免每个页面重复写判断的思路非常正确——这是减少冗余代码、提升可维护性的好设计。问题出在登出后的回调处理上，导致了setState的报错，我们来一步步修复。

报错原因分析 #

当API返回401时，你的_logout()方法执行了pushReplacement，把当前页面直接替换成了登录页。这时候原来页面的State对象已经被移出组件树，但之前发起的API请求的then回调还会继续执行，调用setState()自然就触发了"对已不在组件树中的State调用setState"的错误。

解决方案：分两步优化 #

1. 优化API层的返回逻辑 #

首先修正API代码里的语法错误（比如headers里的分号改成逗号），然后在401处理后返回一个特殊标记（比如null），同时清理无效的token，避免后续请求重复触发错误：

class Api { 
  final String _url = baseUrl + "api/"; 
  // 把_logout改成Future<void>，明确它不返回业务数据
  Future<void> _logout() async { 
    // 第一步：先清理本地的无效token，避免后续请求再携带
    await Prefs.prefs.remove("token");
    // 终止所有pending请求（如果用http.Client实例，这里可以close它）
    // 导航到登录页
    await navigatorKey.currentState?.pushReplacement( 
      MaterialPageRoute( 
        builder: (context) => Login(), 
      ), 
    ); 
  } 
  Future<dynamic?> get(String url) async { 
    String? token = Prefs.prefs.getString("token"); 
    // 提前判断token是否存在，避免无效请求
    if (token == null) {
      await _logout();
      return null;
    }
    Map<String, String> headers = { 
      'accept': 'application/json', 
      'authorization': 'Bearer $token', // 用字符串插值更简洁
    }; 
    try {
      final response = await http.get(Uri.parse(_url + url), headers: headers);
      if (response.statusCode == 200) { 
        return convert.jsonDecode(response.body); 
      } else if (response.statusCode == 401) { 
        await _logout();
        // 返回null标记已登出，让调用方忽略后续处理
        return null;
      } else {
        // 其他状态码抛出异常，让调用方处理
        throw Exception('Request failed with status: ${response.statusCode}');
      }
    } catch (e) {
      // 网络错误等情况，重新抛出异常
      rethrow;
    }
  } 
}

2. 在页面调用时检查组件状态 #

在页面的API回调中，先检查当前State是否还在组件树中（通过mounted属性），再判断返回值是否有效，最后执行setState：

@override 
void initState() { 
  super.initState(); 
  _fetchData();
}

Future<void> _fetchData() async {
  try {
    final response = await Api().get('getdata');
    // 先确认页面还存在，再处理有效响应
    if (mounted && response != null) {
      setState(() { 
        _data = response; 
      });
    }
  } catch (e) {
    // 处理网络错误等其他异常（如果需要）
    if (mounted) {
      // 比如显示错误提示：ScaffoldMessenger.of(context).showSnackBar(...)
    }
  }
}

额外优化建议 #

• 使用Dio库代替原生http：Dio自带拦截器功能，可以更优雅地全局拦截401响应，不需要在每个get/post方法里写判断，还能方便地管理请求取消、超时等。
• 管理请求生命周期：如果你的APP有多个pending请求，登出时可以统一取消这些请求，避免不必要的回调触发。比如用Dio的CancelToken或者http.Client的close()方法。
• 避免直接使用全局navigatorKey：如果可能，尽量通过BuildContext导航，但在API层无法获取context时，使用全局key是可行的方案。

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