Flutter调用无认证REST API始终返回401错误求助

以下是针对你遇到的Postman正常但Flutter调用返回401问题的排查和解决步骤：

• 核对请求体格式与参数
  确认你的API接受的请求体类型：

  • 如果Postman中用的是form-data或x-www-form-urlencoded格式，而你当前代码发送的是JSON格式，就会导致参数解析失败返回401。此时需要修改请求方式：

    // 替换原body和headers
    var result = await widget.httpClient!.post(
      Uri.parse('https://service.xxx.xxx/api/serv/UserLogin'),
      body: {
        'email': formData.email,
        'password': formData.password
      },
      headers: {'content-type': 'application/x-www-form-urlencoded'}
    );
    

  • 检查参数键名是否与API要求一致，比如API要求username而非email，可以通过@JsonKey注解修正：

    @JsonKey(name: 'username')
    String? email;
    

• 同步Postman的请求头
  Postman中可能包含Flutter请求缺失的必要头信息（如User-Agent、Accept等），将Postman里的所有请求头复制到Flutter代码中：

  headers: {
    'content-type': 'application/json',
    'User-Agent': 'PostmanRuntime/7.32.3', // 替换为你Postman的User-Agent
    'Accept': '*/*'
    // 其他Postman中的请求头
  }
  

• 打印请求/响应详情定位问题
  在代码中添加日志，对比Postman的请求内容：

  try {
    final requestBody = json.encode(formData.toJson());
    print('发送的请求体: $requestBody');
    final headers = {'content-type': 'application/json'};
    print('请求头: $headers');
    
    var result = await widget.httpClient!.post(
      Uri.parse('https://service.xxx.xxx/api/serv/UserLogin'),
      body: requestBody,
      headers: headers
    );
    
    print('响应状态码: ${result.statusCode}');
    print('响应内容: ${result.body}');
    // ... 后续逻辑
  } catch (err) {
    print(err.toString());
  }
  

  响应体通常会包含具体错误原因（如"无效的账号密码"或"缺少参数"），能快速定位问题。

• 检查URL与请求方法
  确认请求URL与Postman完全一致（注意大小写、路径拼写），API是否确实接受POST请求。

• HTTPS证书问题（开发环境测试）
  如果你的API使用自签名HTTPS证书，Flutter默认会拒绝请求，可临时禁用证书验证（仅开发环境）：

  import 'dart:io';
  import 'package:http/io_client.dart';
  
  // 在初始化httpClient时使用
  final httpClient = IOClient(HttpClient()
    ..badCertificateCallback = (X509Certificate cert, String host, int port) => true);
  

  生产环境务必配置合法证书，不要使用此方法。

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