如何用Office JS开发Outlook插件实现邮件保存至硬盘、Azure Storage/OneDrive？

一、先解决SaveAsync()失败的核心问题 #

常见失败原因及修复 #

• 权限不足：确保manifest.xml里已声明ReadWriteMailbox权限，对应节点：

  <Permissions>ReadWriteMailbox</Permissions>
  

• API调用时机错误：必须在Office.initialize完成后调用，且确保当前处于邮件阅读界面（插件已加载到目标邮件上下文）。示例代码：

  Office.initialize = function(reason) {
    document.addEventListener('DOMContentLoaded', function() {
      // 在这里绑定按钮点击事件，触发SaveAsync调用
    });
  };
  

• 参数格式错误：调用时必须指定保存格式，比如.eml或.msg，正确调用示例：

  Office.context.mailbox.item.saveAsync(
    { format: Office.MailboxEnums.ItemSaveFormat.Eml },
    function(asyncResult) {
      if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
        console.log("邮件保存至Outlook服务器成功，ID：" + asyncResult.value);
      } else {
        console.error("SaveAsync失败：" + asyncResult.error.message);
      }
    }
  );
  

• 环境限制：优先用Outlook桌面客户端测试，网页版可能存在跨域或权限限制；确保插件已通过管理员授权或个人加载测试。

二、实现多存储目标的具体方案 #

1. 保存至本地硬盘 #

SaveAsync仅将邮件保存到Outlook服务器，要存本地需先获取邮件内容，再触发浏览器下载：

// 获取邮件HTML内容，构造简化版EML（完整EML需解析所有邮件头部，可借助mailparser库）
Office.context.mailbox.item.getAsync(Office.MailboxEnums.ItemProperty.Body, { coercionType: Office.CoercionType.Html }, function(bodyResult) {
  if (bodyResult.status === Office.AsyncResultStatus.Succeeded) {
    const emlContent = `From: ${Office.context.mailbox.item.from.emailAddress.name} <${Office.context.mailbox.item.from.emailAddress.address}>
To: ${Office.context.mailbox.item.to[0].emailAddress.name} <${Office.context.mailbox.item.to[0].emailAddress.address}>
Subject: ${Office.context.mailbox.item.subject}

${bodyResult.value}`;

    // 触发浏览器下载
    const blob = new Blob([emlContent], { type: 'message/rfc822' });
    const url = URL.createObjectURL(blob);
    const downloadLink = document.createElement('a');
    downloadLink.href = url;
    downloadLink.download = `${Office.context.mailbox.item.subject || '未命名邮件'}.eml`;
    document.body.appendChild(downloadLink);
    downloadLink.click();
    document.body.removeChild(downloadLink);
    URL.revokeObjectURL(url);
  }
});

2. 保存至Azure Storage #

• 步骤1：获取邮件内容（参考本地保存的getAsync方法）
• 步骤2：通过Azure Blob SDK上传（需先安装@azure/storage-blob包）：

import { BlobServiceClient } from '@azure/storage-blob';

async function uploadToAzure(emlContent) {
  // 建议通过后端接口获取SAS令牌，避免前端硬编码连接字符串
  const blobServiceClient = BlobServiceClient.fromConnectionString('你的Azure存储连接字符串');
  const containerClient = blobServiceClient.getContainerClient('mail-storage-container');
  const blobName = `${Date.now()}_${Office.context.mailbox.item.subject || '未命名邮件'}.eml`;
  const blockBlobClient = containerClient.getBlockBlobClient(blobName);

  await blockBlobClient.upload(emlContent, emlContent.length, {
    blobHTTPHeaders: { blobContentType: 'message/rfc822' }
  });
  console.log("邮件上传至Azure Storage成功");
}

3. 保存至OneDrive #

借助Microsoft Graph API实现，需先在插件manifest中声明Files.ReadWrite权限：

async function uploadToOneDrive(emlContent) {
  // 获取用户OneDrive访问令牌
  const accessToken = await Office.context.auth.getAccessToken({ allowSignInPrompt: true });
  const fileName = `${Office.context.mailbox.item.subject || '未命名邮件'}.eml`;

  const response = await fetch(`https://graph.microsoft.com/v1.0/me/drive/root:/Documents/${fileName}:/content`, {
    method: 'PUT',
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'message/rfc822'
    },
    body: emlContent
  });

  if (response.ok) {
    console.log("邮件上传至OneDrive成功");
  } else {
    console.error("OneDrive上传失败：" + await response.text());
  }
}

三、调试技巧 #

• 用Office Dev Tools插件查看控制台错误，定位SaveAsync的具体失败原因
• 检查Outlook客户端的插件权限设置，确保已授予读写权限
• 测试时使用已签名的插件包（本地调试需信任加载项）

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