Serverless框架中EventBridge事件总线ARN引用的正确用法

在使用Serverless框架部署AWS Lambda函数时，EventBridge事件总线是一个常用的触发器配置。然而，开发者在配置事件总线ARN引用时容易遇到权限策略生成错误的问题，这会导致Lambda函数无法被正确触发。

问题现象

当开发者使用CloudFormation内部函数（如${AWS::Region}和${AWS::AccountId}）来构造事件总线ARN时，生成的Lambda权限策略会出现异常。具体表现为：

1. 生成的SourceArn格式错误，包含重复的ARN部分
2. 最终生成的权限策略无法正确匹配事件规则

根本原因

Serverless框架在生成Lambda权限策略时，需要构造一个有效的SourceArn用于AWS::Lambda::Permission资源。当使用CloudFormation内部函数引用时：

1. 框架无法在部署前解析这些动态值
2. 导致ARN构造逻辑出现错误，生成不合规的SourceArn

解决方案

正确的做法是直接在配置中指定事件总线名称，而不是完整的ARN。Serverless框架会自动处理ARN的构造工作。

推荐配置方式

functions:
  myFunction:
    handler: handler.main
    events:
      - eventBridge:
          eventBus: my-custom-bus  # 直接使用事件总线名称
          pattern:
            source: ["my.app"]

不推荐的配置方式

以下两种方式都会导致问题：

1. 使用完整ARN并包含CloudFormation内部函数

eventBus: !Sub arn:aws:events:${AWS::Region}:${AWS::AccountId}:event-bus/my-bus

2. 使用完整ARN即使不包含内部函数

eventBus: arn:aws:events:us-east-1:123456789012:event-bus/my-bus

深入理解

Serverless框架的这种设计有其合理性：

1. 简化配置：开发者只需关心业务相关的名称部分
2. 保证一致性：框架可以确保生成的ARN格式符合AWS规范
3. 跨环境兼容：自动适应不同的部署区域和账户

最佳实践

1. 对于自定义事件总线，只需在配置中指定名称
2. 对于默认事件总线，可以完全省略eventBus配置项
3. 避免在事件总线配置中使用任何ARN形式的引用

通过遵循这些实践，可以确保EventBridge事件触发器按预期工作，同时保持配置的简洁性和可维护性。