使用Microsoft Graph API SDK获取邮件时messages字段为空求助

问题根源 #

Graph SDK在获取MailFolder对象时，默认不会自动拉取关联的messages集合，因此直接访问f.messages会触发空指针异常。而你用REST API直接请求了mailFolders/{folder-id}/messages端点，所以能正常拿到邮件数据。

解决办法 #

方法1：获取文件夹时显式加载messages

通过expand方法让SDK在获取文件夹的同时加载关联的邮件集合，还可以用select指定需要的字段，减少不必要的数据传输：

MailFolderCollectionPage mailFolders = graphClient.users("email@domain.com").mailFolders()
    .buildRequest()
    .expand("messages") // 显式加载messages关联资源
    .select("displayName,id,unreadItemCount,totalItemCount,messages") // 指定返回字段
    .get();

for (MailFolder f : mailFolders) {
    System.out.println("## Display Name:" + f.displayName + ", " + f.id);
    System.out.println("  ## Message Count:" + f.messages.getCount());
    System.out.println("  ## Unread item count " + f.unreadItemCount);
    System.out.println("  ## Total item count " + f.totalItemCount);
    
    // 遍历当前文件夹的邮件
    if (f.messages != null && f.messages.getCurrentPage() != null) {
        for (Message msg : f.messages.getCurrentPage()) {
            System.out.println("    - 邮件主题: " + msg.subject);
        }
    }
}

方法2：单独请求每个文件夹的邮件

如果不需要一次性加载所有文件夹的邮件，可以在遍历文件夹时，单独发起邮件请求：

MailFolderCollectionPage mailFolders = graphClient.users("email@domain.com").mailFolders()
    .buildRequest()
    .get();

for (MailFolder f : mailFolders) {
    System.out.println("## Display Name:" + f.displayName + ", " + f.id);
    System.out.println("  ## Unread item count " + f.unreadItemCount);
    System.out.println("  ## Total item count " + f.totalItemCount);
    
    // 单独请求当前文件夹的邮件列表
    MessageCollectionPage messages = graphClient.users("email@domain.com").mailFolders(f.id).messages()
        .buildRequest()
        .get();
    
    System.out.println("  ## Message Count:" + messages.getCount());
    for (Message msg : messages) {
        System.out.println("    - 邮件主题: " + msg.subject);
    }
}

注意事项 #

• 权限检查：确保应用已申请Mail.Read或Mail.ReadWrite权限，且访问令牌包含该权限范围。
• 分页处理：若文件夹内邮件数量较多，SDK会返回分页结果，需调用getNextPage()获取后续页的邮件。

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