Удаление одинаковых строк после импорта скрывает симптом, но не защищает от повторной отправки письма или обработки заказа. Добавьте каждой сущности стабильный ключ источника, а проверку ключа и вставку выполняйте под `LockService`. Тогда повторный trigger возвращает существующий результат вместо второй строки.
Начните с пары дублей: сравните source ID, время создания с точностью до секунд и журнал Apps Script Executions. Одинаковый ID указывает на повторную обработку, разные ID с одинаковым текстом — на проблему источника или неверно выбранный ключ. Перекрывающиеся execution часто означают гонку.
По форме дубля видно механизм
| Картина в таблице | Вероятная причина | Что проверить |
|---|---|---|
| Полностью одинаковые строки подряд | Два параллельных запуска | Время и deployment в Executions |
| Один source ID в разные минуты | Retry или непродвинутый checkpoint | Когда сохраняется cursor |
| Одинаковый текст, разные source ID | Дублирует источник | Политику уникальности бизнеса |
| Повторяется вся пачка | Триггер создан несколько раз | Список My Triggers и setup-функцию |
| Дубль после timeout | Запись прошла, но запуск не увидел успех | Идемпотентность повторного вызова |
Не используйте номер строки как идентификатор: сортировка и вставка меняют его. Ключом может быть order ID, response ID формы, message ID или составной `source + external_id`. Время и имя клиента подходят только если бизнес гарантирует их уникальность.
Ключ и строка фиксируются в одной критической секции
function appendOrderOnce(order) {
const key = `shop:${order.id}`;
const lock = LockService.getScriptLock();
lock.waitLock(15000);
try {
const sheet = SpreadsheetApp.openById(SHEET_ID).getSheetByName('Orders');
const lastRow = sheet.getLastRow();
const keys = lastRow > 1
? new Set(sheet.getRange(2, 1, lastRow - 1, 1).getValues().flat())
: new Set();
if (keys.has(key)) return {inserted: false, key};
sheet.appendRow([key, order.createdAt, order.customer, order.total]);
SpreadsheetApp.flush();
return {inserted: true, key};
} finally {
lock.releaseLock();
}
}Для общей таблицы нужен script lock либо document lock подходящего scope; user lock не остановит разных пользователей. Блокировка считается полученной только после `waitLock` или успешного `tryLock`. Тайм-аут обрабатывайте как retryable error, а не как разрешение писать без lock.
Большой импорт пишет пачкой
Чтение всего столбца для каждой строки быстро становится дорогим. Один раз загрузите существующие ключи, отфильтруйте входную пачку, затем запишите прямоугольный массив одним `setValues`. Критическая секция должна быть короткой: сетевые запросы к источнику выполните до lock, а под lock повторите только проверку свежего набора ключей и запись.
- Нормализуйте тип ключа: строка `00123` не должна случайно стать числом 123.
- Уберите дубли внутри самой входной пачки до обращения к Sheets.
- Проверяйте одинаковую длину каждой строки перед `setValues`.
- Записывайте checkpoint после успешной вставки, а не при начале загрузки.
- Не создавайте новый time-driven trigger при каждом запуске setup.
Checkpoint не заменяет уникальность
PropertiesService удобно хранит cursor последней страницы API, но сбой между записью строк и сохранением cursor повторит страницу. Поэтому импорт всё равно должен распознавать ключи. Обратный порядок — сначала cursor, потом строки — опаснее: при сбое данные будут пропущены.
Для критичных процессов таблица остаётся витриной, а журнал обработанных event IDs лучше хранить в базе с уникальным constraint. Apps Script и Sheets подходят для умеренного потока, но не дают полноценную транзакцию между внешним API, таблицей и побочными действиями.
Регрессия проверяется одновременным запуском
Запустите одну и ту же тестовую пачку из двух вкладок почти одновременно. В таблице должен появиться один ключ, один запуск сообщает `inserted`, другой — `already exists` или ждёт lock. Затем оборвите выполнение после записи и повторите пачку: ключ блокирует второй append.
После исправления дубли прошлого периода очищайте отдельной проверяемой процедурой с резервной копией. Не удаляйте строки по совпадению видимого текста: сначала определите каноническую запись, сохраните связанные формулы и подтвердите бизнес-ключ.