使用Node.js调用Teams Bot API下载文件遇403权限错误求助

问题场景 #

使用Teams Bot API实现图片/文件上传功能：坐席在Teams对话中上传文件，Bot需将文件拉取到我方服务器并转成base64返回给用户。收到的Teams请求包含application/vnd.microsoft.teams.file.download.info类型的附件，其中的downloadUrl是预认证的临时链接，但调用该链接时返回403 Forbidden错误。

当前代码：

if (message.attachments) {
   const file = message.attachments.find(a => a.contentType === "application/vnd.microsoft.teams.file.download.info");
   if (file) {
         require('request').get({uri: file.content.downloadUrl, encoding: null}, function (err, res, body) {
            if (!err && res.statusCode === 200) {
                const base64Data = "data:" + res.headers["content-type"] + ";base64," + new Buffer(body).toString('base64'); 
            } else console.log(err ? err : "statusCode: " + res.statusCode);
        });          
   }}

错误原因分析 #

403错误通常由以下原因导致：

• 请求头缺失必要参数：Teams的SharePoint临时下载链接要求请求携带正确的User-Agent和Referer头，否则会被拦截
• 链接过期：虽然文档说明链接几分钟内有效，但如果Bot处理消息延迟过久，可能导致链接失效
• request库的默认行为问题：request库已停止维护，默认配置可能无法正确传递Cookie或认证相关头信息

解决方案 #

1. 补充必要的请求头 #

在GET请求中添加符合Teams客户端规范的请求头，模拟合法的客户端请求：

const request = require('request');

if (message.attachments) {
   const file = message.attachments.find(a => a.contentType === "application/vnd.microsoft.teams.file.download.info");
   if (file) {
         request.get({
             uri: file.content.downloadUrl,
             encoding: null,
             headers: {
                 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Teams/1.0 Chrome/114.0.0.0 Safari/537.36',
                 'Referer': 'https://teams.microsoft.com/'
             }
         }, function (err, res, body) {
             if (!err && res.statusCode === 200) {
                 const base64Data = `data:${res.headers["content-type"]};base64,${Buffer.from(body).toString('base64')}`;
                 // 后续处理base64数据
             } else {
                 console.log(err ? err : `statusCode: ${res.statusCode}`);
             }
         });          
   }
}

2. 确保立即处理下载请求 #

在Bot收到消息的第一时间发起下载请求，避免链接过期。如果Bot有消息队列或延迟处理逻辑，需调整优先级优先处理文件下载任务。

3. 替换维护活跃的请求库（推荐） #

request库已停止维护，建议替换为axios或node-fetch等现代库，默认行为更符合HTTP规范：
使用axios的示例：

const axios = require('axios');

if (message.attachments) {
   const file = message.attachments.find(a => a.contentType === "application/vnd.microsoft.teams.file.download.info");
   if (file) {
         axios.get(file.content.downloadUrl, {
             responseType: 'arraybuffer',
             headers: {
                 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Teams/1.0 Chrome/114.0.0.0 Safari/537.36',
                 'Referer': 'https://teams.microsoft.com/'
             }
         })
         .then(response => {
             const base64Data = `data:${response.headers["content-type"]};base64,${Buffer.from(response.data).toString('base64')}`;
             // 后续处理
         })
         .catch(error => {
             console.log(error.response ? `statusCode: ${error.response.status}` : error.message);
         });
   }
}

4. 验证链接有效性 #

如果以上方法仍无效，可临时将downloadUrl复制到浏览器中打开：

• 如果浏览器也无法下载，说明链接本身已过期或无效，需检查Bot接收消息的延迟情况
• 如果浏览器可以下载但代码不行，说明请求头或库的配置仍有问题

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