使用GRAPH API下载MIME速度远慢于OWA，如何提升速率？

针对你遇到的Graph API下载大邮件EML速度远慢于OWA的问题，以下是几个可落地的优化方法：

1. 升级Graph Client版本 #

你当前用的@microsoft/microsoft-graph-client@^2.2.1是较老的版本，后续v3及以上版本在HTTP请求底层做了不少性能优化，包括流处理效率的提升。先升级到最新稳定版测试：

npm install @microsoft/microsoft-graph-client@latest

升级后代码无需大幅改动，但底层的请求复用、流传输效率会有明显提升。

2. 启用HTTP/2传输 #

Graph API支持HTTP/2，而旧版client可能默认使用HTTP/1.1。HTTP/2的多路复用特性能大幅提升大文件传输速度。在Node.js环境下初始化Client时可配置HTTP/2 agent：

import * as http2 from 'http2';
import { Client } from '@microsoft/microsoft-graph-client';
import { TokenCredentialAuthenticationProvider } from '@microsoft/microsoft-graph-client/authProviders/azureTokenCredentials';
import { ClientSecretCredential } from '@azure/identity';

const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
const authProvider = new TokenCredentialAuthenticationProvider(credential, {
  scopes: ['https://graph.microsoft.com/.default']
});

// 配置HTTP/2 agent，开启长连接
const agent = new http2.Agent({
  keepAlive: true,
  maxSessionMemory: 100 * 1024 * 1024 // 按需调整内存上限
});

const graphClient = Client.initWithMiddleware({
  authProvider,
  httpClient: {
    fetch: (url: RequestInfo, options?: RequestInit) => {
      return new Promise((resolve, reject) => {
        const targetUrl = new URL(url.toString());
        const session = agent.connect(`${targetUrl.protocol}//${targetUrl.host}`);
        
        const req = session.request({
          ':method': options?.method || 'GET',
          ':path': targetUrl.pathname + targetUrl.search,
          ...options?.headers
        });

        const dataChunks: Buffer[] = [];
        req.on('data', chunk => dataChunks.push(chunk));
        req.on('end', () => {
          const responseBody = Buffer.concat(dataChunks);
          resolve(new Response(responseBody, {
            status: req.statusCode,
            headers: req.headers
          }));
          session.close();
        });
        req.on('error', err => reject(err));
        
        if (options?.body) {
          req.write(options.body);
        }
        req.end();
      });
    }
  }
});

浏览器环境下HTTP/2通常由浏览器自动处理，无需额外配置。

3. 分块并行下载（Range请求） #

对于大文件，使用Range请求分块下载，并行获取不同片段后合并，既能避免单次请求超时，又能利用并发提升速度：

async function downloadLargeMessage(msgId: string, chunkSize = 5 * 1024 * 1024) {
  // 先获取文件总大小
  const headRes = await graphClient.api(`/me/messages/${msgId}/$value`).head();
  const totalSize = parseInt(headRes.headers.get('content-length') || '0');
  
  const chunks: Buffer[] = [];
  let startOffset = 0;

  // 可通过Promise.all控制并发数，例如同时下载3块
  while (startOffset < totalSize) {
    const endOffset = Math.min(startOffset + chunkSize - 1, totalSize - 1);
    const chunkStream = await graphClient.api(`/me/messages/${msgId}/$value`)
      .header('Range', `bytes=${startOffset}-${endOffset}`)
      .getStream();
    
    // 将流转换为Buffer
    const chunkBuffer = await new Promise<Buffer>((resolve, reject) => {
      const bufferList: Buffer[] = [];
      chunkStream.on('data', chunk => bufferList.push(chunk));
      chunkStream.on('end', () => resolve(Buffer.concat(bufferList)));
      chunkStream.on('error', err => reject(err));
    });
    
    chunks.push(chunkBuffer);
    startOffset = endOffset + 1;
  }

  return Buffer.concat(chunks);
}

注意控制并发数，避免触发Graph API的限流机制。

4. 排查限流与网络问题 #

• 检查是否被限流：查看响应头中的x-ms-throttle-limit和x-ms-ratelimit-remaining字段，若剩余配额不足，说明已被限流，需调整请求频率。
• 切换就近端点：国内用户可使用中国区Graph API端点microsoftgraph.chinacloudapi.cn，降低网络延迟。

5. 直接使用Fetch API绕开Client库 #

Client库的封装可能带来额外性能开销，直接用原生Fetch API发起请求，减少中间层损耗：

async function downloadEmlDirectly(msgId: string, accessToken: string) {
  const res = await fetch(`https://graph.microsoft.com/v1.0/me/messages/${encodeURIComponent(msgId)}/$value`, {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${accessToken}`
    }
  });

  if (!res.ok) {
    throw new Error(`下载失败: ${res.statusText}`);
  }

  return res.body; // 返回原生ReadableStream
}

原生Fetch的流处理通常更高效，适合大文件下载场景。

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