Google Sheets非GSuite环境onEdit获取用户邮箱失效问题及解决方案

个人版谷歌账号（非GSuite/谷歌Workspace）使用的谷歌表格，此前18个月一直可通过onEdit触发器在单元格被编辑时，自动写入当前编辑用户的邮箱，核心代码逻辑如下：

function onEdit(e) {
     const userEmail = Session.getActiveUser().getEmail();
     // 原有写入单元格逻辑
     ....
}

该功能2021年10月初突然失效，即使可在单元格编辑历史中查看编辑者信息，代码也因安全限制无法将用户名写入单元格。此前尝试禁用V8 runtime、创建单一可安装onEdit触发器、通过高级Google服务添加Drive API获取用户名、旧兼容方案、重新授权权限均无法解决问题。

分步解决方法 #

1. 运行环境配置 #

必须启用脚本的V8 runtime，禁用旧版runtime。

2. 触发器配置 #

每一位需要使用该自动记录功能的表格协作用户，都需要单独为该脚本创建onEdit可安装触发器，并且完成对应的权限授权，不可由表格所有者统一创建触发器供所有用户使用。

3. 解决多触发器并发冲突 #

完成前两步配置后，多个用户的独立onEdit触发器会出现并发冲突，导致写入的邮箱被其他用户的触发器误删，需要给onEdit的执行逻辑添加文档锁，优化后代码如下：

function onEdit(e) {
  var lock = LockService.getDocumentLock();
  // 等待获取锁的最长时间为20秒，可根据实际使用场景调整
  lock.waitLock(20000);
  // 原有业务逻辑写在此处，例如获取编辑者邮箱、写入指定单元格等操作
  const editUser = Session.getActiveUser().getEmail();
  // 示例：将编辑者邮箱写入当前编辑行的第5列，可自行修改对应的行列规则
  e.range.getSheet().getRange(e.range.rowStart, 5).setValue(editUser);
  // 强制提交所有 pending 的表格写入操作
  SpreadsheetApp.flush();
  // 执行完成后释放锁
  lock.releaseLock();
}

核心注意事项 #

• 非商用谷歌套件（个人版账号）不支持通过单一触发器适配所有协作用户，必须每个用户单独创建触发器并完成授权
• 必须使用V8 runtime才能正常获取当前编辑用户的邮箱信息
• 必须给onEdit的执行逻辑添加文档锁，避免多用户同时编辑时触发器并发触发导致的写入内容被覆盖、删除等异常

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