Dart递归异步函数获取Microsoft Graph邮件文件夹问题排查

我来帮你分析这个问题，Dart完全支持异步递归，所以问题肯定出在代码逻辑上，咱们一步步拆解：

问题1：递归调用时的ID引用错误 #

你在构造MailFolder时，递归请求子文件夹的URL用了folder[i].id，但这时候folder[i]是你刚刚添加到列表里的对象——虽然ID已经赋值，但这种写法容易因为索引混乱出问题（比如当列表长度动态变化时）。正确的做法是直接用数据源里的ID，也就是data["value"][i]["id"]，这样更可靠且不易出错。

问题2：缺失异常捕获，导致静默失败 #

你的代码没有任何try-catch块，当递归过程中出现网络错误、API授权失败或者JSON解析错误时，Future会抛出异常，但因为没有被捕获，整个递归链会静默终止，看起来就像函数突然停止了。

问题3：循环逻辑的冗余与潜在顺序问题 #

你在while循环里处理当前页的value，然后请求nextLink，之后又在循环外处理最后一个page的value——其实可以把这部分逻辑合并，避免重复代码。另外，用索引遍历的for循环容易出错，换成直接遍历每个文件夹数据的方式会更清晰。

修复后的代码示例 #

Future<List<MailFolder>> getFolders(String request) async {
  var prefs = await SharedPreferences.getInstance();
  List<MailFolder> folders = [];
  
  try {
    var response = await http.get(
      Uri.parse(request), // 用Uri.parse替代Uri.encodeFull，处理URL更安全
      headers: {"Authorization": "Bearer " + "你的AccessToken"},
    );

    // 先检查API响应状态码，提前发现错误
    if (response.statusCode != 200) {
      throw Exception("API请求失败：${response.statusCode}，响应内容：${response.body}");
    }

    var data = JsonDecoder().convert(response.body);

    // 遍历当前页的所有文件夹数据
    for (var folderData in data["value"]) {
      // 递归获取当前文件夹的子文件夹
      var childFolders = await getFolders(
        "https://graph.microsoft.com/v1.0/me/mailFolders/${folderData["id"]}/childFolders",
      );
      
      // 创建并添加文件夹对象到列表
      folders.add(MailFolder(
        folderData["displayName"],
        folderData["unreadItemCount"],
        folderData["totalItemCount"],
        folderData["id"],
        childFolders,
      ));
    }

    // 如果存在下一页链接，递归获取并合并结果
    if (data["@odata.nextLink"] != null) {
      var nextPageFolders = await getFolders(data["@odata.nextLink"]);
      folders.addAll(nextPageFolders);
    }

    return folders;
  } catch (e) {
    // 捕获并打印所有异常，方便排查问题
    print("获取文件夹出错：$e");
    // 根据业务需求，这里可以返回空列表或者重新抛出异常
    return [];
  }
}

额外优化建议 #

• 把AccessToken的获取逻辑抽离成单独的函数，避免重复代码，同时可以加入token过期检查逻辑。
• 给http请求添加超时设置，避免长时间等待无响应的请求占用资源。
• 如果用户的文件夹层级很深、数量很大，可以考虑用Stream异步流来逐步返回结果，降低内存压力。

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