如何使用ews-javascript-api从Directory文件夹获取联系人？报错排查

嘿，这个问题我之前踩过坑！你遇到的The distinguished folder name is unrecognized错误，核心原因是Directory并不是EWS预定义的「特殊文件夹标识符（DistinguishedFolderId）」——EWS的DistinguishedFolderId只针对用户自己邮箱内的默认文件夹（比如「你的联系人」就是属于你自己的默认Contacts文件夹），而Directory这类要么是组织级别的全局目录，要么是自定义共享文件夹，不能直接用这种方式调用。

下面分两种常见场景给你解决方案：

场景1：你要访问的是全局地址簿（GAL）里的联系人 #

如果Directory指的是公司的全局地址簿，那它根本不是一个可遍历的文件夹，而是需要通过搜索接口来获取数据。可以用ResolveName或者FindItems方法来检索：

// 示例：搜索GAL中的联系人（注意：GAL不支持全量遍历，建议加搜索条件）
let resolveResults = await exch.ResolveName("*", ews.ResolveNameSearchLocation.DirectoryOnly, true);
for (let result of resolveResults) {
    // 筛选出邮箱类型的联系人
    if (result.Mailbox.Type === ews.MailboxType.Mailbox) {
        // 绑定获取联系人详情
        let contact = await ews.Contact.Bind(exch, result.Mailbox.Id);
        console.log(`联系人：${contact.DisplayName}，邮箱：${contact.EmailAddresses[ews.EmailAddressKey.EmailAddress1]}`);
    }
}

注意：GAL不支持无限制的全量遍历，如果你需要获取大量联系人，建议按部门、姓名前缀等条件分段搜索，避免触发Office365的限流。

场景2：你要访问的是某个共享邮箱/用户邮箱里的「Directory」自定义联系人文件夹 #

如果Directory是某个用户或共享邮箱里创建的自定义联系人文件夹，你需要先通过搜索找到它的FolderId，再进行联系人读取：

// 示例：查找共享邮箱中名为"Directory"的联系人文件夹
const sharedMailboxEmail = "shared-folder@yourcompany.com"; // 替换为实际邮箱地址
let folderView = new ews.FolderView(10);
folderView.PropertySet = new ews.PropertySet(ews.BasePropertySet.FirstClassProperties);
// 过滤条件：文件夹名称等于"Directory"
let filter = new ews.SearchFilter.IsEqualTo(ews.FolderSchema.DisplayName, "Directory");

// 搜索目标邮箱的Contacts根目录下的自定义文件夹
let folderResults = await exch.FindFolders(
    new ews.FolderId(ews.WellKnownFolderName.Contacts, new ews.Mailbox(sharedMailboxEmail)),
    filter,
    folderView
);

if (folderResults.Items.length > 0) {
    let directoryFolder = folderResults.Items[0];
    // 读取该文件夹下的联系人
    let itemView = new ews.ItemView(100); // 每次最多读取100条，可分页
    let contactResults = await exch.FindItems(directoryFolder.Id, itemView);
    
    // 处理联系人数据
    for (let contact of contactResults.Items) {
        console.log(`联系人：${contact.DisplayName}`);
    }
} else {
    console.log("未找到名为Directory的文件夹");
}

前提条件：你的账号必须拥有该共享文件夹的读取权限，否则会返回权限错误。

额外注意事项 #

• 确认EWS版本：你当前用的是Exchange2013版本，建议换成ExchangeOnline更适配Office365环境：

  let exch = new ews.ExchangeService(ews.ExchangeVersion.ExchangeOnline);
  

• 权限验证：确保你的账号在Office365中被授予了EWS访问权限，并且目标文件夹的权限设置正确。

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