Flutter升级后Dart HttpClient基础认证（Basic Authentication）失效问题

咱们先从你给出的日志和报错信息入手，把问题拆成两个核心部分来解决：

1. 先处理代码中的类型不匹配异常 #

你看到的 type '(Exception) => void' is not a subtype of type '(Object) => FutureOr<dynamic>' 是Flutter升级后，错误处理回调的类型约束变严格导致的。原来的代码里用了只接收Exception类型的回调，但现在catchError要求回调能接收所有Object类型的错误，并且返回FutureOr<dynamic>类型的结果。

修复方法：
把原来的错误处理代码，比如：

.catchError((Exception e) {
  // 原来的错误处理逻辑
});

改成：

.catchError((Object e) {
  // 保持你的错误处理逻辑，比如打印错误信息
  print('Login error: $e');
  // 如果不需要返回结果，直接返回null即可满足FutureOr要求
  return null;
});

2. 解决认证凭证无法传递的问题 #

从服务器日志能看到，Flutter发送的请求完全没有带上凭证（credentials:: -），但curl请求正常，这说明原来的请求配置在Flutter升级后失效了。问题大概率出在依赖withCredentials自动传递凭证的逻辑上——框架升级后这个配置的默认行为或者生效条件变了。

更可靠的方式是手动添加Basic Auth的Authorization请求头，不受框架版本变动影响，具体代码如下：

用http包实现的示例 #

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<void> performLogin() async {
  // 你的账号凭证
  final username = 'W';
  final password = 'T';
  // 对凭证进行Base64编码，符合Basic Auth格式要求
  final authCredentials = base64Encode(utf8.encode('$username:$password'));

  try {
    final response = await http.get(
      Uri.parse('http://localhost:5000/users/login'),
      headers: {
        // 手动添加Authorization头
        'Authorization': 'Basic $authCredentials',
      },
    );

    if (response.statusCode == 200) {
      print('登录成功：${response.body}');
    } else {
      print('登录失败，状态码：${response.statusCode}，返回内容：${response.body}');
    }
  } catch (e) {
    print('登录过程出错：$e');
  }
}

用dart:io的HttpClient实现的示例 #

如果你习惯用原生HttpClient，也可以这样写：

import 'dart:convert';
import 'dart:io';

Future<void> performLogin() async {
  final username = 'W';
  final password = 'T';
  final authCredentials = base64Encode(utf8.encode('$username:$password'));

  final client = HttpClient();
  try {
    final request = await client.getUrl(Uri.parse('http://localhost:5000/users/login'));
    // 添加Authorization头
    request.headers.add('Authorization', 'Basic $authCredentials');
    // 如果服务器需要Cookie等其他凭证，再开启withCredentials，Basic Auth本身不需要
    // request.headers.set(HttpHeaders.withCredentialsHeader, 'true');
    
    final response = await request.close();
    final responseBody = await utf8.decodeStream(response);

    if (response.statusCode == 200) {
      print('登录成功：$responseBody');
    } else {
      print('登录失败，状态码：${response.statusCode}，返回内容：$responseBody');
    }
  } catch (e) {
    print('登录过程出错：$e');
  } finally {
    client.close();
  }
}

关于429限流的补充说明 #

日志里出现两次GET /users/login请求，这是触发限流的原因。修复上面的代码后，错误处理逻辑不再触发重复请求，就能避免短时间内多次请求导致的429错误。

用修改后的代码测试，你应该能看到服务器日志里出现credentials:: W - T，并且返回200的成功状态，和curl请求的结果一致。

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