Google Apps Script调用string.split报错：IDE正常，web请求触发split is not a function

核心问题原因 #

• Google Apps Script 中，HTTP请求触发的事件对象e的parameters属性下的所有查询参数，默认返回数组类型，即使你只传了一次该参数。
• 你在网页IDE中测试时，手动构造的测试事件直接给files赋值为字符串类型，所以split方法可以正常调用；但PowerShell发起的真实HTTP请求到达服务端时，e.parameters.files实际是["你传入的逗号拼接ID串"]格式的数组，数组没有split方法，因此触发报错。
• 你看到的typeof filestr返回string的日志是IDE测试场景下的输出，并非PowerShell调用时的实际运行日志，两者事件结构不一致才导致表现不同。

你提到的JS原始值包装对象机制和本次问题无关 #

JS中字符串原始值调用split等方法时，确实会临时创建String包装对象承载方法，执行完成后销毁，该机制是JS原生设计的正常逻辑，不会引发split is not a function错误，只有调用方法的变量本身不具备该方法时才会抛出该异常。

修复方案 #

1. 服务端（Google Apps Script）侧修改（最稳妥） #

修改filestr的取值逻辑，兼容数组和字符串两种输入：

let filestr = e.parameters.files;
// 兼容数组类型的参数值
if (Array.isArray(filestr)) {
  filestr = filestr[0];
}
// 强制转换为字符串，避免边缘场景下的类型问题
filestr = String(filestr);
let files = filestr.split(",");

2. PowerShell侧可选优化 #

对传入的查询参数做URL编码，避免特殊字符导致参数解析异常：

$queryString = "files=$([Uri]::EscapeDataString($query))"

内容的提问来源于stack exchange，提问作者justin.k.pierson