serverless.yaml部署DynamoDB触发器时Filter Pattern未生效问题

• 项目使用技术栈：Lambda、DynamoDB、DynamoDB Streams，Lambda运行时为.NET 6
• 业务需求：DynamoDB表插入新记录时触发Lambda，仅响应INSERT类型的流事件
• 手动配置验证结果：在Lambda控制台手动添加DynamoDB流触发器、配置事件过滤规则时功能正常，仅INSERT事件会触发Lambda
• 异常现象：通过serverless.yaml部署时，DynamoDB流触发器可正常创建并在控制台显示，但配置的过滤规则不生效，INSERT/MODIFY/REMOVE三类流事件都会触发Lambda执行
• 前置校验：已通过YAML校验工具确认配置文件无语法错误

当前使用的serverless.yaml函数配置如下：

functions: 
  operation-handler: 
      name: com-sit-operation
      description: operation-task
      handler: OperationTask::OperationTask.Operation::OperationFunction 
      timeout: ${self:custom.lambdaTimeout}
      disableLogs: false
      events:
          - stream:
              type: dynamodb
              arn: ${self:custom.tableStreamArn}
              filterPatterns:
                - eventName: [INSERT]
              batchSize: 30
              startingPosition: LATEST
              batchWindow: 300
              enabled: true

1. Serverless Framework版本不兼容
   Lambda事件源映射过滤规则（Filter Criteria）是AWS 2021年末上线的功能，Serverless Framework从v2.67.0版本才开始原生支持filterPatterns配置项。如果本地部署使用的框架版本低于该阈值，部署过程会直接忽略filterPatterns字段，仅创建基础DynamoDB流触发器，不会将过滤规则同步到AWS侧，最终所有类型的流事件都会触发Lambda。
2. 第三方插件逻辑覆盖
   如果serverless.yaml的plugins段引入了DynamoDB流相关第三方插件（例如流ARN自动解析插件、本地调试类插件、旧版事件源管理插件），这类插件可能会接管流触发器的创建流程，且多数旧版本插件未适配filterPatterns字段解析逻辑，会直接丢弃过滤配置。
3. 配置校验方式错误
   仅在Lambda控制台的触发器列表页无法确认过滤规则是否生效，必须进入触发器详情页，查看「过滤条件」板块是否存在配置的规则。如果详情页过滤条件为空，即可确认部署阶段配置未同步到AWS侧。

• 升级框架版本：执行npm install -g serverless@latest升级到最新稳定版，重新部署后到触发器详情页确认过滤规则已正常同步。
• 排查插件冲突：临时移除所有和DynamoDB流、事件源映射相关的第三方插件，重新部署验证过滤规则是否生效。如果确认是插件导致的问题，可升级对应插件到支持过滤配置的版本，或直接使用框架原生配置逻辑。
• CloudFormation原生配置兜底：如果框架或插件的兼容问题无法快速解决，可以删除functions段下的stream事件配置，直接在resources段通过原生CloudFormation语法定义事件源映射，绕开框架的事件解析逻辑，示例配置如下：

resources:
  Resources:
    OperationHandlerEventSourceMapping:
      Type: AWS::Lambda::EventSourceMapping
      Properties:
        EventSourceArn: ${self:custom.tableStreamArn}
        FunctionName: com-sit-operation
        BatchSize: 30
        StartingPosition: LATEST
        MaximumBatchingWindowInSeconds: 300
        Enabled: true
        FilterCriteria:
          Filters:
            - Pattern: '{"eventName": ["INSERT"]}'

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