CloudFormation创建AWS::AppSync Pipeline类型JS解析器失败求助

1. YAML多行字符串格式错误 #

直接把JS代码塞进Code参数的字符串里，YAML的多行格式很容易踩坑：

• 必须用|来保留代码的换行和缩进，确保AppSync能正确解析JS结构，示例：

  Code: |
    export function request(ctx) {
      return { version: '2018-05-29', payload: ctx.args };
    }
    export function response(ctx) {
      return ctx.result;
    }
  

• 别用>，它会自动折叠换行，把你的JS代码揉成一团，直接触发语法错误。

2. JS代码不符合AppSync规范 #

AppSync的JS运行环境有严格要求，不是随便写Node.js代码就行：

• 每个Function必须导出request和response两个函数，少一个都不行。
• 不能用Node.js核心模块（比如fs、http），只能用AppSync内置的API和ctx对象。
• 检查基础语法：比如漏写分号、括号不配对、变量未定义，这些低级错误都会返回BadRequestException。

3. Pipeline Resolver的结构配置不全 #

Pipeline类型的Resolver不能只填Code，必须配置PipelineConfig：

• 要在Resolver资源里指定PipelineConfig.Functions，引用对应的AWS::AppSync::FunctionConfiguration资源，JS代码是写在每个Function的Code参数里，不是Resolver的Code里。
• 正确的结构示例：

  MyPipelineResolver:
    Type: AWS::AppSync::Resolver
    Properties:
      ApiId: !Ref MyAppSyncApi
      TypeName: Query
      FieldName: getItems
      Kind: PIPELINE
      PipelineConfig:
        Functions:
          - !Ref FirstPipelineFunction
          - !Ref SecondPipelineFunction
  
  FirstPipelineFunction:
    Type: AWS::AppSync::FunctionConfiguration
    Properties:
      ApiId: !Ref MyAppSyncApi
      Name: FirstFunction
      DataSourceName: !Ref MyDynamoDBDataSource
      Runtime:
        Name: APPSYNC_JS
        RuntimeVersion: 1.0.0
      Code: |
        export function request(ctx) {
          return { 
            version: '2018-05-29', 
            operation: 'Scan',
            limit: ctx.args.limit || 10
          };
        }
        export function response(ctx) {
          return ctx.result.items;
        }
  

4. 特殊字符未转义 #

如果JS代码里有YAML特殊字符（比如双引号、#、:），要处理转义：

• 用|包裹的多行字符串里，双引号不需要转义，但如果是单行字符串，要么把双引号换成单引号，要么用反斜杠转义。

5. 未指定JS运行时版本 #

要明确指定AppSync JS的运行时版本，否则可能默认用旧版本，不支持新语法：

• 在FunctionConfiguration里加上Runtime参数，示例如上，目前推荐用1.0.0或更高版本。

6. 数据源与代码逻辑不匹配 #

JS代码的返回格式要和关联的数据源类型匹配：

• 比如对接DynamoDB，request函数要返回符合DynamoDB操作规范的格式；对接Lambda，要返回Lambda能接收的payload结构，格式错了也会触发错误。

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