Flutter iOS生产构建中‘Bad File descriptor’报错含义及排查

可能原因与修复方案 #

1. 未捕获网络底层异常

当前代码仅处理了响应状态码非200的业务错误，但未捕获http.post调用时可能出现的网络级异常（比如连接中断、超时、资源泄漏等），这类底层错误会直接暴露为「Bad File descriptor」。

修复代码：
给请求逻辑添加全局异常捕获，区分网络错误与业务错误：

static Future<dynamic> post(
  String endPoint, {
  Map<String, dynamic>? body,
}) async {
  var uri = Uri.parse(_apiUrl + endPoint);
  print('post: $uri');
  print('body: $body');

  try {
    final response = await http.post(
      uri,
      body: body != null ? json.encode(body) : null,
      headers: {
        'Content-type': 'application/json',
      },
      timeout: const Duration(seconds: 10),
    );

    _checkResponse(response);
    return json.decode(response.body);
  } on SocketException catch (e) {
    print('Socket exception: $e');
    throw NetworkException(
      ExceptionError.fromMap({'message': '网络连接异常'}),
      statusCode: -1,
    );
  } on TimeoutException catch (e) {
    print('Request timeout: $e');
    throw NetworkException(
      ExceptionError.fromMap({'message': '请求超时'}),
      statusCode: -2,
    );
  } catch (e) {
    print('Unexpected error: $e');
    rethrow;
  }
}

2. 修复body为null时的无效编码

原代码中当body为null时，json.encode(body)会生成字符串"null"，不符合标准JSON请求格式，可能触发后端或iOS网络层的异常处理逻辑。

修复点：
将body: json.encode(body)改为body: body != null ? json.encode(body) : null，确保无请求体时不传递无效内容。

3. 检查iOS ATS配置

生产环境中iOS的App Transport Security（ATS）可能限制非HTTPS请求或特定域名连接，导致请求中途被中断，触发文件描述符错误。

操作步骤：
打开ios/Runner/Info.plist，确认已配置目标API域名的ATS例外（优先使用HTTPS，仅必要时添加例外）：

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <false/>
  <key>NSExceptionDomains</key>
  <dict>
    <key>你的API域名</key>
    <dict>
      <key>NSIncludesSubdomains</key>
      <true/>
      <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
      <true/>
    </dict>
  </dict>
</dict>

4. 排查连接资源泄漏

Flutter的http包默认使用HTTP/1.1连接池，若生产环境存在大量未正确清理的挂起请求，可能导致文件描述符耗尽。

优化方案：

• 确保所有请求都正常完成或被取消，避免长时间挂起
• 可考虑替换为dio库，它对连接池和资源管理的处理更健壮

额外调试建议 #

• 在生产环境开启详细网络日志，捕获请求完整生命周期
• 测试低网络环境下的请求表现，确认是否为网络波动导致的连接中断

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