AWS CDK：AppSync JavaScript解析器DynamoDB数据源验证与错误处理问题

问题场景 #

我在使用AppSync JavaScript解析器对接DynamoDB数据源时，对验证和错误处理的最佳实践不太熟悉。当前遇到的问题是：

• 在request函数中返回含错误信息的自定义对象时，会触发「必须指定operation」的错误
• 希望验证失败时完全避免调用DynamoDB（防止产生不必要的费用），但尝试抛出普通错误、提前返回错误对象都无效；返回带operation的对象会触发DynamoDB调用，用假操作名也会报错

解决方案 #

在AppSync的JavaScript解析器中，要在request阶段终止请求且不触发数据源调用，正确的方式是使用AppSync内置的util.error()方法抛出标准错误，而不是返回自定义错误对象或普通throw语句。

核心要点

• 不要返回带error字段的自定义对象：AppSync会默认解析request返回值为数据源操作结构（比如DynamoDB要求的operation字段），自定义对象会触发格式校验错误
• 使用util.error()直接终止流程：该方法会立即中断请求，不会执行后续的数据源调用，同时返回标准化的错误信息给客户端
• 可自定义错误类型和附加数据：方便前端区分不同错误场景（如权限错误、参数验证错误等）

修改后的代码示例 #

export function request(ctx: Context) {
  const cognitoSub = (ctx.identity as AppSyncIdentityCognito)?.claims?.sub;
  const { firstName, lastName, country } = ctx.arguments || {};

  if (!cognitoSub) {
    util.error('用户未认证 - 缺少Cognito Sub.', 'Unauthorized');
  }

  if (!firstName || firstName.trim() === '') {
    util.error('验证失败 - 名字为必填项.', 'ValidationError');
  }

  if (!lastName || lastName.trim() === '') {
    util.error('验证失败 - 姓氏为必填项.', 'ValidationError');
  }

  // 构建验证通过后的属性对象
  const attributes: UserAttributes = {};
  if (firstName) attributes.firstName = firstName;
  if (lastName) attributes.lastName = lastName;
  if (country) attributes.country = country;

  // 验证通过，执行DynamoDB更新操作
  return {
    operation: 'UpdateItem',
    key: util.dynamodb.toMapValues({
      'PK': `USER#${cognitoSub}`,
      'SK': 'PROFILE#v1'
    }),
    attributeValues: util.dynamodb.toMapValues(attributes),
    returnValues: 'ALL_NEW'
  };
}

额外最佳实践 #

• 验证逻辑前置：把所有参数、权限验证放在request函数最开头，尽早终止无效请求，避免不必要的计算和资源消耗
• 错误类型标准化：统一使用如Unauthorized、ValidationError、BadRequest等错误类型，便于前端统一处理错误提示
• 避免返回非法结构：request函数的返回值要么是符合数据源要求的操作对象（如DynamoDB的UpdateItem结构），要么用util.error()抛出错误，不要返回其他格式的对象

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