Google Apps Script中ContactsApp.getContacts()行为异常及联系人导入续传问题求助

咱们一步步来解决你遇到的这三个问题，先从共性原因入手，再针对性处理：

一、执行链随机中断、导入数量不匹配的问题 #

背后的坑： #

1. ContactsApp.getContacts()返回的数组不是固定的：每次调用这个方法，返回的联系人顺序甚至内容可能发生变化——比如期间有人新增/删除联系人，或者Google Contacts的排序逻辑有变动，导致前后两次触发器执行时，contacts.length或者数组里的元素对应不上，要么重复导入，要么漏导，自然就出现中断或者数量不对的情况。
2. 进度保存太“滞后”：你只在快到4分钟时才保存last_index，但Google Apps Script的超时判断有时候不是那么精准，万一脚本突然被强制终止，last_index还没来得及更新，下一次触发器就会从旧的位置开始，导致整个导入逻辑混乱。
3. appendRow拖慢了速度：每次循环都调用appendRow，相当于每次都发送一次API请求，速度慢不说，还容易因为网络波动出现写入失败，最后就会出现导入数量和实际联系人总数不匹配的情况。

修复办法： #

1. 给联系人加固定排序：调用getContacts()时指定排序规则，确保每次拿到的数组顺序完全一致，比如按全名升序排列：

   // 固定排序，避免每次数组顺序乱跳
   var contacts = ContactsApp.getContacts(ContactsApp.SortFields.FULL_NAME, ContactsApp.SortOrder.ASCENDING);
   

2. 分批处理+实时存进度：别等快超时才存进度，每处理50条（可以根据实际情况调整数量）就存一次last_index，同时把要写入的数据攒成数组，最后用setValues批量写入，速度能快好几倍：

   var batchSize = 50; // 每50条批量处理一次
   var dataBatch = [];
   var userProperties = PropertiesService.getUserProperties();
   var last_index = parseInt(userProperties.getProperty('last_index')) || 0;
   var contacts = ContactsApp.getContacts(ContactsApp.SortFields.FULL_NAME, ContactsApp.SortOrder.ASCENDING);
   
   for(var i = last_index; i < contacts.length; ++i){
       var name = contacts[i].getFullName();
       dataBatch.push([name]);
       
       // 每攒够batchSize条，就写入表格并更新进度
       if((i - last_index + 1) % batchSize === 0){
           var nextRow = sheet.getLastRow() + 1;
           sheet.getRange(nextRow, 1, dataBatch.length, 1).setValues(dataBatch);
           dataBatch = [];
           userProperties.setProperty('last_index', i + 1);
       }
       
       // 用官方的剩余时间判断，比固定4分钟靠谱
       if(Utilities.getScriptTimeLeft() < 30){ // 留30秒处理收尾
           // 先把剩余数据写入
           if(dataBatch.length > 0){
               var nextRow = sheet.getLastRow() + 1;
               sheet.getRange(nextRow, 1, dataBatch.length, 1).setValues(dataBatch);
           }
           // 更新最后处理的索引
           userProperties.setProperty('last_index', i + 1);
           // 这里放你的触发器创建代码
           // createTrigger();
           break;
       }
   }
   // 处理循环结束后剩下的零散数据
   if(dataBatch.length > 0){
       var nextRow = sheet.getLastRow() + 1;
       sheet.getRange(nextRow, 1, dataBatch.length, 1).setValues(dataBatch);
   }
   // 如果全部处理完，清空进度并删除触发器
   if(i >= contacts.length){
       userProperties.deleteProperty('last_index');
       // 这里放删除触发器的代码，避免残留
       // deleteTriggers();
   }
   

3. 用Utilities.getScriptTimeLeft()判断超时：这个方法能准确拿到当前脚本还剩多少执行时间，比你自己设定4分钟要靠谱得多，留30秒处理收尾工作，避免突然中断导致进度丢失。

二、手动续传总是从第0位开始的问题 #

核心原因： #

还是**ContactsApp.getContacts()的顺序不固定**！你手动续传时用表格的已写入行数当起始索引，但两次调用getContacts()返回的联系人顺序可能完全不一样——比如上次导入的第100个联系人，这次在数组里是第0位，结果你从第100位开始，导入的是新的联系人，看起来就像从0开始重复导入了。

另外还有可能是你计算last_row时没考虑表头：比如表格第一行是表头，那已导入的联系人数量应该是sheet.getLastRow() - 1，如果直接用sheet.getLastRow()当索引，肯定会从错误的位置开始。

修复办法： #

1. 手动续传也用固定排序：和触发器执行时一样，手动续传时也要用同样的排序规则获取联系人数组，确保顺序一致。
2. 优先用userProperties的进度，而不是表格行数：手动续传时，先读userProperties里的last_index，如果没有（比如第一次手动执行），再根据表格行数计算，记得减去表头：

   var userProperties = PropertiesService.getUserProperties();
   var last_index;
   var storedIndex = userProperties.getProperty('last_index');
   if(storedIndex){
       last_index = parseInt(storedIndex);
   } else {
       // 假设表格第一行是表头，所以减1
       last_index = sheet.getLastRow() - 1;
       // 防止索引变成负数
       last_index = last_index < 0 ? 0 : last_index;
   }
   // 必须用固定排序的联系人数组
   var contacts = ContactsApp.getContacts(ContactsApp.SortFields.FULL_NAME, ContactsApp.SortOrder.ASCENDING);
   for(var i = last_index; i < contacts.length; ++i){
       // 你的处理逻辑
       var name = contacts[i].getFullName();
       // ...
   }
   

3. 手动续传后记得更新进度：手动执行完后，把最新的last_index存到userProperties里，这样下次无论是触发器还是手动续传，都能从正确的位置开始。

额外小建议 #

• 加个去重机制：可以在表格里记录联系人的唯一ID（用contacts[i].getId()获取），每次导入前检查这个ID是否已经在表格里，这样就算顺序变了或者进度丢了，也不会重复导入。
• 加日志调试：在关键步骤加Logger.log()，比如记录每次的last_index、contacts.length、处理的联系人ID，方便排查问题：

  Logger.log(`开始处理，起始索引：${last_index}，总联系人数：${contacts.length}`);
  

内容的提问来源于stack exchange，提问作者swdmnd