Google Apps Script中UrlFetchApp.fetch发起GET返回空对象{}问题咨询

最常见的认知误区：日志里的{}不是真实的空返回 #

90%遇到这个问题的开发者，本质是误判了UrlFetchApp的返回结果：UrlFetchApp.fetch返回的是HTTPResponse类的实例，并非普通可枚举的JavaScript对象。如果直接在Apps Script的日志里打印这个实例本身，就会输出形如{}的内容——这不是没有拿到响应，只是类实例的内部属性没有暴露成可遍历的键值对，直接打印看不到实际存储的内容。
对应正确操作：必须调用实例自带的方法提取实际响应内容，不能直接打印实例本身：

• 获取HTTP状态码：response.getResponseCode()
• 获取响应文本正文：response.getContentText()
• 获取响应头信息：response.getHeaders()
  参考可运行的正确示例代码：

function testUrlFetch() {
  // 错误写法：Logger.log(UrlFetchApp.fetch("https://www.google.com")) 输出结果为{}
  const res = UrlFetchApp.fetch("https://www.google.com");
  // 正确的取值写法
  Logger.log("请求状态码：" + res.getResponseCode());
  Logger.log("响应内容长度：" + res.getContentText().length);
}

真实返回空响应的常见触发原因与解决方案 #

如果确认已经通过方法取值，最终拿到的仍然是空内容，按以下顺序排查：

• 授权范围缺失
  如果项目启用了自定义appsscript.json清单配置，没有添加外部请求对应的授权范围https://www.googleapis.com/auth/script.external_request，请求会被权限校验直接拦截。如果代码中写了粗略的异常捕获，就会把拦截结果包装成空对象。需要在清单配置中补充对应授权范围，重新完成脚本授权流程即可解决。
• 目标站点反爬拦截
  google.com等站点对没有合规请求头的自动化请求，会返回空响应或直接拦截。需要给fetch请求补充模拟浏览器的请求配置，同时开启重定向跟随：

  const requestConfig = {
    headers: {
      "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/125.0.0.0 Safari/537.36"
    },
    followRedirects: true,
    muteHttpExceptions: false // 关闭异常屏蔽，暴露真实HTTP错误
  };
  const res = UrlFetchApp.fetch("https://www.google.com", requestConfig);
  

• 组织层面的网络管控
  如果是企业Workspace环境下运行的脚本，管理员可能配置了外部请求域名白名单，未在白名单内的站点会被直接拦截。这种情况需要联系Workspace管理员调整UrlFetch的访问策略。

标准化排查流程 #

1. 先把muteHttpExceptions配置设为false，避免所有HTTP异常被静默吞掉，拿到真实的错误信息
2. 换无反爬的测试地址（如https://example.com）发起同样的请求，如果测试地址能正常拿到内容，说明是目标站点的请求限制问题，不是UrlFetch接口本身故障
3. 逐行打日志定位空值出现的位置，区分是请求未发出、请求被拦截、还是返回的响应本身就是空内容

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