Office Add-ins JS API与Graph API邮件ID及MIME内容获取问题

一、Office Add-ins JavaScript API能否直接获取MIME内容？ #

目前不支持直接通过Office Add-ins JavaScript API获取邮件MIME内容，必须借助Microsoft Graph API实现，你的整体思路是可行的，但需要优化ID处理逻辑和错误应对方案。

二、404（ErrorItemNotFound）错误解决办法 #

• 正确转换邮件ID编码
  Office Add-ins返回的itemId是Base64编码格式，不能简单手动替换/为-，要做标准的Base64 URL编码：把+换成-，/换成_，同时去掉末尾的=填充字符。代码示例：

  function convertToGraphId(officeItemId) {
    // 移除末尾的等号
    let trimmedId = officeItemId.replace(/=+$/, '');
    // 替换为URL安全的Base64字符
    return trimmedId.replace(/\+/g, '-').replace(/\//g, '_');
  }
  

  错误的手动替换会导致ID损坏，这是404错误的主要诱因。
• 确认权限与邮件状态
  确保调用Graph API的令牌拥有Mail.Read及以上权限；检查数据库存储的ID是否完整，有没有被截断或篡改。如果邮件已被删除或移动到归档、垃圾邮件文件夹，要改用/me/deleteditems/{id}或对应文件夹的端点查询。

三、503（ErrorMailboxMoveInProgress）错误解决办法 #

• 实现指数退避重试机制
  邮箱迁移是临时状态，可添加重试逻辑，每次重试间隔翻倍：

  async function fetchMimeContentWithRetry(graphId, maxRetries = 3, delay = 1000) {
    for (let i = 0; i < maxRetries; i++) {
      try {
        const response = await fetch(`https://graph.microsoft.com/v1.0/me/messages/${graphId}/$value`, {
          headers: { 'Authorization': `Bearer ${accessToken}` }
        });
        if (response.status === 503 && i < maxRetries - 1) {
          await new Promise(resolve => setTimeout(resolve, delay * Math.pow(2, i)));
          continue;
        }
        return await response.text();
      } catch (error) {
        if (error.message.includes('ErrorMailboxMoveInProgress') && i < maxRetries - 1) {
          await new Promise(resolve => setTimeout(resolve, delay * Math.pow(2, i)));
          continue;
        }
        throw error;
      }
    }
    throw new Error('已达最大重试次数，请稍后再试');
  }
  

• 提示用户临时状态
  如果重试后仍失败，可在插件界面提示用户“邮箱正在迁移中，请稍后再尝试获取内容”。

四、额外优化建议 #

• 直接在插件内调用Graph API：不用把ID存入数据库再单独调用，可在插件中直接获取访问令牌后调用Graph API，减少中间环节的ID问题。获取令牌示例：

  Office.context.auth.getAccessTokenAsync({ allowSignInPrompt: true }, function(result) {
    if (result.status === "succeeded") {
      const accessToken = result.value;
      // 用accessToken调用Graph API获取MIME内容
    } else {
      // 处理令牌获取失败逻辑
    }
  });
  

• 提前验证ID有效性：存储ID前先调用/me/messages/{id}端点验证，避免存储无效ID。

内容的提问来源于stack exchange，提问作者R. Mohammad