Office Scripts调用外部API返回202却触发捕获异常问题求助

核心原因及修复方案 #

1. 跨域策略限制 #

Office Scripts运行在Office沙箱中，对外部API的CORS规则要求严格。即便API返回202，若响应头未包含Access-Control-Allow-Origin（需覆盖Office域名，如https://office.com）、Access-Control-Allow-Methods: POST及必要的请求头许可，浏览器会直接拦截响应，触发catch块。
修复：在API响应中添加符合要求的CORS头，生产环境避免使用*作为允许源，指定Office相关域名。

2. 响应体解析失败 #

API返回202时可能无响应体，或响应体格式非JSON，但代码中直接调用response.json()会导致解析错误，进入catch。
修复：先判断响应状态与体内容，再选择解析方式：

fetch('YOUR_API_ENDPOINT', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(yourPayload)
})
.then(response => {
  console.log('响应状态:', response.status);
  // 先读取文本避免JSON解析报错
  return response.text().then(text => ({ response, text }));
})
.then(({ response, text }) => {
  console.log('响应体:', text);
  let data;
  if (text) {
    try {
      data = JSON.parse(text);
    } catch (parseErr) {
      console.log('JSON解析失败:', parseErr.message);
    }
  }
  // 处理202逻辑
  if (response.status === 202) {
    console.log('任务已接受:', data);
  }
})
.catch(err => {
  // 打印完整错误细节
  console.log('Catch错误:', err.message, err.stack);
});

3. Office环境的请求限制 #

Office Scripts禁止HTTP请求，仅支持HTTPS；同时部分敏感请求头（如Host）无法自定义，若API依赖这些头会导致请求异常。
修复：确保API使用HTTPS协议，移除请求中Office不允许的敏感头字段。

排查技巧 #

• 打印完整错误信息：在catch块中输出err.message、err.stack，获取浏览器级别的错误详情（如跨域提示）。
• 对比测试：用Postman/curl发送相同请求，确认响应头、响应体与Office Scripts请求的差异，定位环境导致的问题。

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