Postman中Basic Auth正常，Flutter Dio请求报404的问题排查与解决

问题场景 #

使用Basic Auth令牌时，Postman请求接口完全正常，但通过Flutter的Dio框架配置相同请求头后，始终返回404错误。

Postman配置（原提问含两张配置截图，此处略）

Flutter Dio实现代码：

final Dio _basicAuthDio = Dio();
String cred = "username:password";
String credEnc = utf8.fuse(base64).encode(cred);
_basicAuthDio.options = BaseOptions(
  baseUrl: "${ApiConstants.baseUrl}v2",
  headers: {HttpHeaders.contentTypeHeader: "application/json", "Authorization": "Basic $credEnc"},
);

可能原因及解决方法 #

1. BaseUrl拼接错误（最常见） #

检查ApiConstants.baseUrl的末尾是否包含斜杠：

• 如果baseUrl是https://your-domain.com，拼接v2后会变成https://your-domain.comv2，这显然是无效URL，直接导致404。
• 解决：修改baseUrl拼接方式，确保路径正确：

  baseUrl: "${ApiConstants.baseUrl}/v2",
  

  或者确保ApiConstants.baseUrl末尾自带斜杠（如https://your-domain.com/）。

2. Basic Auth编码不一致 #

Postman的Basic Auth编码逻辑是直接对username:password做Base64编码，需验证Dio中的编码结果是否和Postman一致：

• 解决：在代码中打印credEnc的值，复制到Postman的Authorization头中测试。如果编码结果不同，检查username/password是否包含特殊字符（如空格、中文），确保编码过程一致。也可以改用更简洁的编码写法：

  _basicAuthDio.options.headers[HttpHeaders.authorizationHeader] = 
      'Basic ${base64Encode(utf8.encode('username:password'))}';
  

3. 请求URL/方法差异 #

即使接口"一致"，也可能存在路径拼接或请求方法的隐性差异：

• 解决：给Dio添加日志拦截器，查看完整请求详情：

  _basicAuthDio.interceptors.add(LogInterceptor(
    requestHeader: true,
    requestBody: true,
    responseBody: true,
  ));
  

  同时在Postman中点击「Code」按钮（右上角），生成对应请求的代码，对比两者的URL、请求方法、头信息，找出差异。

4. 请求头缺失差异 #

Postman会自动添加一些默认请求头（如User-Agent、Accept），部分服务器会校验这些头信息，缺失时返回404：

• 解决：在Dio的headers中补全Postman的默认头，示例：

  headers: {
    HttpHeaders.contentTypeHeader: "application/json",
    HttpHeaders.userAgentHeader: "PostmanRuntime/7.32.3",
    HttpHeaders.acceptHeader: "*/*",
    "Authorization": "Basic $credEnc"
  }
  

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