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

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

本文详解如何修复 google apps script 中因未正确获取文件输入（``）导致的 `uncaught typeerror: failed due to illegal value in property: "รูป"` 错误，重点说明前端文件 blob 获取、后端安全接收与 sheets 写入的完整链路。

该错误的根本原因在于：前端 JavaScript 尝试将一个未定义的变量 selectedFile 直接赋值给 task.รูป 字段，导致传入 Apps Script 的 formData 中该属性为 null；而 Google Apps Script 的 e.parameter 对象无法解析 null 或 Blob 类型值作为普通表单参数——尤其当字段名含非 ASCII 字符（如泰文“รูป”）时，会触发严格校验失败。

✅ 正确做法：分离文本数据与文件数据，使用 google.script.run.withSuccessHandler().uploadFiles()

Google Apps Script 不支持直接通过 e.parameter 接收 <input type="file"> 的二进制内容。必须使用 google.script.run 的 withSuccessHandler + 表单 FormData 对象进行多部分（multipart）上传，并在服务端用 e.postData.contents 解析。

? 前端修复（HTML + JS）

首先，移除错误的 selectedFile 引用，改用 FormData 动态收集所有字段（含文件）：

<script>  function saveForm() {    const form = document.getElementById('myForm');    const formData = new FormData(form); // ✅ 自动包含所有 input（含 file）    // 为每个动态行补充唯一标识（可选，便于后端关联）    const rows = document.querySelectorAll('.row.g-3');    rows.forEach((row, i) => {      const inputs = row.querySelectorAll('input');      formData.append(`row${i}_ลำดับ`, inputs[0].value);      formData.append(`row${i}_รายการ`, inputs[1].value);      if (inputs[2].files.length > 0) {        formData.append(`row${i}_รูป`, inputs[2].files[0]); // ✅ 追加 File 对象      }      formData.append(`row${i}_หมายเหตุ`, inputs[3].value);    });    // 调用 GAS 函数（注意：需启用 withSuccessHandler）    google.script.run      .withSuccessHandler(() => alert('บันทึกสำเร็จ!'))      .withFailureHandler(err => alert('ข้อผิดพลาด: ' + err.message))      .saveFormData(formData); // ✅ 传递 FormData 对象  }</script>

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

? 后端修复（Google Apps Script）

修改 saveFormData 函数以支持 FormData 解析，并单独处理文件上传（不能直接写入 Sheets）：

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 中，<script> 必须放在 </body> 前，且 google.script.run 可用（即页面由 HtmlService 正确渲染）。

? 总结

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

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