本文详解如何修复 Google Apps Script 中因未正确获取文件输入（）导致的 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 接收 的二进制内容。必须使用 google.script.run 的 withSuccessHandler + 表单 FormData 对象进行多部分（multipart）上传，并在服务端用 e.postData.contents 解析。

? 前端修复（HTML + JS）

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

Google Sheets

Google Sheets 安全管理工作：用于创建、读取、写入、追加电子表格数据；管理工作表（读取/添加/删除）；复制电子表格。

下载

<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>

⚠️ 注意：

标签中 必须移除 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  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> 必须放在 </script>