在 GAS 中通过 Web App 并行调用 appendRow() 写入多行数据时，因缺乏跨请求同步机制，易导致多线程竞争同一插入位置，造成行覆盖或错位；应改用基于 Lock Service 的 appendRows_() 批量安全写入方案。
在 gas 中通过 web app 并行调用 `appendrow()` 写入多行数据时，因缺乏跨请求同步机制，易导致多线程竞争同一插入位置，造成行覆盖或错位；应改用基于 lock service 的 `appendrows_()` 批量安全写入方案。
Google Apps Script（GAS）的 Sheet.appendRow() 方法本身是原子性的——即单次调用中写入的一整行内容不会被其他请求“切开”或混入中间。但它不保证多线程下多次调用的顺序性与位置隔离性。当多个并发请求（如 Web App 中通过 google.script.run 触发的 30 个 myFunction(i)）几乎同时执行 appendRow()，它们会各自独立查询当前最后一行位置、再写入下一行。由于查询与写入之间存在微小时间窗口（非事务性），极易发生“竞态条件（race condition）”：两个请求读到相同的末行索引（例如第100行），均向第101行写入，导致后执行者覆盖前者，造成数据丢失。
因此，问题根源不在 appendRow() 的原子性失效，而在于缺乏跨执行上下文的写入协调机制。解决方案不是放弃并行，而是将“多行写入”封装为一个受保护的临界区操作。
✅ 推荐方案：使用带锁的批量追加函数 appendRows_()
以下是一个经过生产验证的安全工具函数，利用 GAS 的 LockService 实现分布式互斥写入：
/**
* 安全地批量追加多行数据到指定工作表（支持并发）
* @param {string} spreadsheetId - 目标电子表格 ID
* @param {string} sheetName - 工作表名称
* @param {Array<array>} rows - 要追加的二维数组，每子数组为一行
*/
function appendRows_(spreadsheetId, sheetName, rows) {
const lock = LockService.getScriptLock();
try {
// 获取锁（最多等待 30 秒，避免死锁）
lock.waitLock(30000);
const ss = SpreadsheetApp.openById(spreadsheetId);
const sheet = ss.getSheetByName(sheetName);
if (!sheet) throw new Error(`Sheet "${sheetName}" not found`);
// 批量写入：一次 setValues() 比多次 appendRow() 高效且位置连续
if (rows.length > 0) {
const lastRow = sheet.getLastRow();
const targetRange = sheet.getRange(lastRow + 1, 1, rows.length, rows[0].length);
targetRange.setValues(rows);
}
} catch (e) {
console.error('Failed to append rows:', e);
throw e;
} finally {
lock.releaseLock(); // 确保释放锁，即使出错
}
}</array>
? 关键设计说明：
- 使用 LockService.getScriptLock() 实现脚本级全局锁，确保任意时刻仅一个并发请求能进入写入逻辑；
- 避免逐行 appendRow()，改用 setValues() 一次性写入全部数据，既提升性能，又彻底杜绝行间穿插；
- 显式错误处理与 finally 中释放锁，防止锁长期占用。
✅ 修改后的主逻辑（适配原代码）
function myFunction(n) {
const lists = [
[1000 + n, 2000 + n, 3000 + n],
[4000 + n, 5000 + n, 6000 + n],
[7000 + n, 8000 + n, 9000 + n]
];
// ✅ 替换原 writedown(lists)，传入固定 ID 和表名
appendRows_("~~~~~~~~~~", "~~", lists); // ← 安全批量写入
}
⚠️ 注意事项与最佳实践
- 锁超时设置合理：waitLock(30000) 提供 30 秒等待窗口，适用于绝大多数场景；若业务逻辑极长（如含外部 API 调用），建议拆分为「准备数据」+「持锁写入」两阶段，缩短临界区。
- 避免锁内耗时操作：appendRows_() 中不应包含 UrlFetchApp.fetch()、复杂计算等，只做纯 Sheet I/O。
- 不要滥用 PropertiesService 做位置计数：曾有方案尝试用 Properties 存储“下一行号”并加锁递增，但该方式在高并发下仍可能因读-改-写非原子性而失效；getLastRow() + setValues() 是更可靠、更符合 Sheets 底层行为的设计。
- 前端无需修改：原有 HTML 中的并行调用逻辑（for 循环触发 30 次 myFunction）完全保留，appendRows_() 自动处理并发协调。
✅ 总结
解决 GAS 并行写入冲突的核心原则是：将非原子的“多次单行追加”转化为原子的“单次多行写入”，并用 Lock Service 保障该操作的独占性。appendRows_() 不仅修复了数据丢失问题，还显著提升了写入效率（减少 API 调用次数）。在 Web App、定时触发器或多用户协作场景中，这是保障数据完整性的标准实践。
