如何在AWS Cognito custom message触发器中阻止发信且不触发报错

核心思路 #

不需要通过抛出错误阻止发信，通过修改触发器返回值配合可选的预注册配置即可实现无错误跳过邮件发送，同时保证SignUp接口正常返回结果。

具体实现方案 #

方案1：结合预注册触发器+自定义消息触发器（适配大多数场景） #

• 第一步：在Pre sign-up（预注册）触发器中对需要跳过欢迎邮件的用户，设置自动确认和自动邮箱验证标记，避免Cognito触发验证类邮件的发送逻辑：

// Pre sign-up触发器示例
exports.handler = async (event) => {
  if (needSkipWelcomeEmail(event.userName)) { // 自定义判断是否要跳过发信的逻辑
    event.response.autoConfirmUser = true;
    event.response.autoVerifyEmail = true;
  }
  return event;
};

• 第二步：在Custom Message触发器中对符合跳过条件的注册请求，清空邮件内容字段，Cognito检测到空内容会自动跳过投递，不会抛出错误：

// Custom Message触发器示例
exports.handler = async (event) => {
  // 仅处理注册场景的自定义消息触发
  if (event.triggerSource === 'CustomMessage_SignUp' && needSkipWelcomeEmail(event.userName)) {
    event.response.emailSubject = '';
    event.response.emailMessage = '';
    return event;
  }
  // 其他场景正常生成邮件内容
  event.response.emailSubject = '欢迎注册平台';
  event.response.emailMessage = `你的注册验证码为：${event.request.codeParameter}`;
  return event;
};

方案2：使用自定义邮件发送触发器（可控性更高） #

如果需要更灵活的发信控制，可在用户池配置中将邮件发送通道改为自定义Lambda触发器，在该触发器中直接判断是否需要发信，不需要发送的场景直接返回即可，完全不会影响上游SignUp接口的返回结果。

注意事项 #

不要在Custom Message触发器中抛出任何错误，只要按要求返回修改后的event对象即可，SignUp接口会正常返回用户ID等预期响应。
如果用户池配置了强制邮箱验证规则，必须配合预注册触发器的autoVerifyEmail配置，否则即使清空注册欢迎邮件内容，Cognito后续仍可能触发验证邮件的发送。

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