Google Apps Script 多字段表单文件上传的正确实践

本文详解如何修复 Google Apps Script 中因未正确获取文件输入（）导致的 Uncaught TypeError: Failed due to illegal value in property: "" 错误，重点说明前端文件 Blob 获取、后端安全接收与 Sheets 写入的完整链路。

该错误的本质是前后端数据格式不匹配。在前端 JavaScript 中，未声明的变量 selectedFile 被直接赋值给 task. 字段，导致传递到 GAS 后端的 e.parameter 中该属性值为 null。GAS 对表单参数校验严格，尤其当字段名包含非 ASCII 字符（如泰文的“”）时，会直接抛出“非法值”报错。

正确的解决方法是彻底分离文本数据和文件数据，使用 google.script.run.withSuccessHandler().uploadFiles() 处理。GAS 本身不支持通过 e.parameter 直接接收 的二进制内容，必须使用 google.script.run 配合 withSuccessHandler，并在前端利用 FormData 对象进行多部分上传，服务端通过 e.postData.contents 解析。下面逐步说明。

前端修复（HTML + JS）

不再使用 selectedFile 变量，直接使用 FormData 动态收集所有表单字段（包括文件）。参考代码：

注意：

标签中必须移除 onsubmit="event.preventDefault(); saveForm();"，改为在按钮中调用 saveForm()；同时确保 enctype="multipart/form-data" 已存在（你已有，很好）。

后端修复（Google Apps Script）

修改 saveFormData 函数，使其能正确解析 FormData，并单独处理文件上传——文件不能直接写入 Sheets，需先存到 Drive 再存储链接。

function saveFormData(formData) {
  //  使用 e.postData.contents 解析 multipart 数据（仅在 doPost 中可用）
  // 注意：此函数必须由 google.script.run 从客户端调用，且需配置为 doPost 触发器
  const sheet = SpreadsheetApp.openById('xxx').getActiveSheet();
  const destinationFolderId = 'xxx';

  // 存储每行的文本数据（不含文件）
  const textRows = [];

  // 遍历 formData 中的所有键（格式为 row0_, row0_, row1_...）
  const keys = Object.keys(formData);
  const maxRow = Math.max(...keys.map(k => {
    const match = k.match(/^row(\d+)_.+/);
    return match ? parseInt(match[1], 10) : -1;
  }).filter(n => n >= 0));

  for (let i = 0; i <= maxRow; i++) {
    const row = [
      formData[`row${i}_`] || '',
      formData[`row${i}_`] || '',
      '', // 临时留空 —— 文件链接将后续填入
      formData[`row${i}_`] || ''
    ];

    //  如果有上传文件，则上传到 Drive 并写入文件 URL
    if (formData[`row${i}_`]) {
      try {
        const fileBlob = formData[`row${i}_`]; // GAS 自动解析为 Blob
        const folder = DriveApp.getFolderById(destinationFolderId);
        const file = folder.createFile(fileBlob);
        row[2] = file.getUrl(); // 将文件链接写入“”列
      } catch (e) {
        console.error(`上传第 ${i} 行图片失败:`, e);
        row[2] = '上传失败';
      }
    }
    textRows.push(row);
  }

  // 批量写入 Sheets（高效且避免多次调用）
  if (textRows.length > 0) {
    const lastRow = sheet.getLastRow();
    sheet.getRange(lastRow + 1, 1, textRows.length, 4).setValues(textRows);
  }

  return ContentService.createTextOutput('OK').setMimeType(ContentService.MimeType.TEXT);
}

关键点：

• google.script.run.saveFormData(formData) 会自动触发 doPost(e)，此时 e.parameter 不再适用，应使用 e.postData.contents —— 但更简单的方式是：直接在 saveFormData 函数签名中接收 formData 参数，GAS 会自动反序列化 FormData 中的文本字段，并将文件字段转为 Blob 对象（需确保部署为“执行方式：任何人，即使匿名者”或“仅限我的组织”，且启用 V8 运行时）。
• 文件字段名必须唯一（如 row0_），避免多个同名 导致覆盖。
• 永远不要把 Blob 或 null 直接 push 到 newData 数组再 setValues() —— Sheets 只接受字符串、数字、日期等基本类型。

部署前必做检查

1. 在 Apps Script 编辑器中，点击 Deploy → Manage deployments → Edit → Execute as: Me → Who has access: Anyone（若需匿名提交）；
2. 确保 doPost 函数已设为 Web App 的入口（但本方案推荐直接调用 saveFormData，无需显式 doPost）；
3. 在 HTML 中， 必须放在 前，且 google.script.run 可用（即页面由 HtmlService 正确渲染）。

总结

• 错误模式：data[''] = selectedFile（变量未声明 → undefined → null → GAS 拒绝）；
• 正确模式：用 FormData 收集全部字段 → GAS 自动识别 Blob → 单独上传文件 → 将文件链接（而非 Blob）存入 Sheets；
• - 字段名支持 Unicode（如“”），但需前后端完全一致，且避免空格/特殊符号；
• - 多行批量处理提升性能，减少 Sheets API 调用次数。

遵循以上结构，即可彻底解决 "" 属性非法值报错，并构建健壮的多文件表单上传系统。