Google Apps Script调用BigQuery.Jobs.query报语法错误如何解决？

报错本质是BigQuery服务端返回的SQL语法错误，不是Apps Script代码本身的语法问题。报错指向var queryResults行是因为这行是实际发起BigQuery API调用的位置，语法错误出在你传入的{{query}}对应的SQL语句中，错误位置为SQL文本第1行第232个字符处。

• 第一步：打印完整SQL定位错误
  在定义request变量前添加日志输出完整的拼接后SQL：

  // 新增日志行
  Logger.log('最终提交的SQL：' + {{query}});
  var request = {
    query: {{query}},
    useLegacySql: false
  };
  

  执行脚本后打开Apps Script的「执行日志」，复制完整的SQL内容，粘贴到BigQuery控制台直接运行，即可直观看到语法错误的具体位置。
• 第二步：重点检查动态变量拼接逻辑
  脚本中定义了today日期变量，大概率是你拼接该变量到SQL时没有正确加引号、或者拼接边界错误，导致SQL中多出来多余的右括号：
  错误拼接示例：

  // 错误：日期没有加单引号包裹，会导致SQL语法断裂
  var query = "SELECT * FROM 你的表名 WHERE dt = " + today;
  

  正确拼接示例：

  // 正确：用单引号包裹日期类型的值
  var query = "SELECT * FROM 你的表名 WHERE dt = '" + today + "'";
  

• 第三步：检查特殊字符转义
  如果你的SQL中包含带单引号、反斜杠的字符串内容，或者依赖外部输入拼接，没有做转义会导致SQL引号提前闭合，触发语法错误。
• 第四步：用固定SQL验证根因
  把request中的query替换为最简单的固定测试SQL，确认环境正常：

  var request = {
    query: "SELECT 1 AS test_col",
    useLegacySql: false
  };
  

  如果测试运行成功，即可100%确认是原有动态SQL拼接逻辑的问题，针对性修改即可。

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