使用Amazon Lambda+API Gateway搭建Trello Webhook遇404错误求助

常见排查点及修复方案 #

• 确认API Gateway已部署
  未部署的API Gateway会直接返回404，务必检查你的API已经发布到目标阶段（比如prod），在API Gateway控制台的「部署」页面可以查看并完成发布操作。

• 匹配Trello请求路径与API资源路径
  Trello会直接请求你提供的回调URL，要确保API Gateway中定义的资源路径和方法完全匹配：比如你给Trello的URL是https://xxxx.execute-api.us-east-1.amazonaws.com/prod/trello-webhook，那API Gateway必须存在/trello-webhook资源，且该资源配置了POST方法（Trello的验证请求和后续事件推送都用POST）。

• 检查Lambda集成权限与触发器

  1. 在API Gateway的集成请求中，确认Lambda函数ARN正确，且执行角色拥有调用该Lambda的权限。
  2. 查看Lambda的触发器列表，确保API Gateway已被添加为触发器，且关联的阶段、资源与你提供给Trello的URL一致。

• 正确处理Trello的验证请求
  Trello创建Webhook时会发送带challenge参数的POST请求，你的Lambda必须解析并返回该参数，同时返回200状态码。以下是Python示例代码：

  import json
  
  def lambda_handler(event, context):
      body = json.loads(event['body'])
      if 'challenge' in body:
          return {
              'statusCode': 200,
              'body': body['challenge']
          }
      # 处理后续Webhook事件逻辑
      return {
          'statusCode': 200,
          'body': json.dumps({'msg': 'Event received'})
      }
  

  若未正确处理challenge请求，Trello可能会将非预期响应判定为无效URL，间接返回404错误。

• 排查自定义域名与阶段变量（若使用）
  如果你用了自定义域名，要确认域名解析正确，API Gateway的基础路径映射配置无误；若使用阶段变量，需检查变量值是否会导致路径匹配异常。

• 通过CloudWatch日志定位问题
  查看Lambda和API Gateway的CloudWatch日志：

  • API Gateway日志可查看请求是否到达、资源匹配情况、集成错误信息。
  • Lambda日志能确认函数是否被触发，以及执行过程中的报错细节。

便捷创建Trello Webhook的替代方式 #

如果手动配置仍有问题，可尝试用Trello官方CLI工具快速创建：

1. 安装工具：npm install -g trello-cli
2. 配置API密钥和令牌：trello configure（密钥和令牌需从Trello开发者页面获取）
3. 创建Webhook：

   trello webhook create --idModel YOUR_BOARD_ID --callbackURL YOUR_API_GATEWAY_URL
   

   这种方式可快速验证Webhook的可用性，排除手动配置的细节问题。

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