本文详解如何修复 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" 已存在（你已有，很好）。
Work Productivity Gog Google Workflow Helper下载帮助用户满足已验证的需求：代理用户在Clawhub上对Gog式工作流有强烈需求，需要实际帮助修复bug、强化设置等。
? 后端修复（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 只接受字符串、数字、日期等基本类型。
? 部署前必做检查
- 在 Apps Script 编辑器中，点击 Deploy → Manage deployments → Edit → Execute as: Me → Who has access: Anyone（若需匿名提交）；
- 确保 doPost 函数已设为 Web App 的入口（但本方案推荐直接调用 saveFormData，无需显式 doPost）；
- 在 HTML 中，<script> 必须放在 </body> 前，且 google.script.run 可用（即页面由 HtmlService 正确渲染）。
? 总结
- ❌ 错误模式：data['รูป'] = selectedFile（变量未声明 → undefined → null → GAS 拒绝）；
- ✅ 正确模式：用 FormData 收集全部字段 → GAS 自动识别 Blob → 单独上传文件 → 将文件链接（而非 Blob）存入 Sheets；
- ? 字段名支持 Unicode（如“รูป”），但需前后端完全一致，且避免空格/特殊符号；
- ? 多行批量处理提升性能，减少 Sheets API 调用次数。
遵循以上结构，即可彻底解决 "รูป" 属性非法值报错，并构建健壮的多文件表单上传系统。
