Serverless Framework部署后AWS Lambda未添加指定外部Layer问题排查

我来帮你梳理几个大概率导致这个问题的原因，都是用Serverless Framework配置Lambda Layer时容易踩的坑：

1. layers字段格式错误 #

这是最常见的问题！你的配置里layers直接写了单个ARN，但Serverless Framework要求这个字段是数组类型——哪怕只有一个Layer，也需要用方括号[]包裹。正确的配置应该是：

functions:
  api:
    handler: functions/api/handler.run
    layers: 
      - arn:aws:lambda:eu-central-1:347034527139:layer:tf_keras_pillow:1
    events:
      - http:
          path: /image/{id}/{mode}
          method: get
          request:
            parameters:
              paths:
                id: true
                mode: true

如果不用数组格式，Serverless会直接忽略这个配置项，自然不会把Layer关联到函数上。

2. 部署权限不足 #

你用来部署项目的IAM角色，需要具备访问这个外部Layer的权限：

• 必须包含lambda:GetLayerVersion权限，允许获取目标Layer的版本信息
• 如果这个Layer属于其他AWS账号，对方必须已经将该Layer共享给你的账号（或设置为公开访问，不推荐）
  可以检查部署过程中的日志，如果有权限相关报错，需要调整IAM策略或者联系Layer所有者配置共享。

3. 区域不匹配 #

Lambda Layer是区域专属资源，你的Serverless项目部署区域必须和Layer所在的eu-central-1完全一致。检查serverless.yml根节点的region配置：

service: your-service-name
provider:
  name: aws
  region: eu-central-1  # 必须与Layer区域完全一致

如果部署到了其他区域，Lambda找不到对应区域的目标Layer，就无法完成关联。

4. Serverless Framework版本过旧 #

早期版本的Serverless Framework对Lambda Layer的支持存在bug或格式要求差异。可以尝试升级到最新稳定版：

npm install -g serverless

升级后重新部署，看问题是否解决。

5. 未排查部署日志 #

部署时的隐性错误可能不会终止流程，但会跳过Layer关联步骤。重新运行serverless deploy，仔细查看输出日志，有没有类似“Layer not found”的警告或报错，这些信息能直接定位问题。

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