Serverless Framework配置Lambda角色时遇未定义资源错误求助

从你提供的信息来看，核心问题是生成的CloudFormation模板中缺失了doStuffFromInsideVPC角色资源——尽管你在serverless.yml里定义了它，但最终的模板里没有这个资源条目，导致CloudFormation报错找不到引用。下面是具体的排查和修复步骤：

1. 优先修正IAM策略的Version字段（最可能的根因） #

AWS IAM策略仅支持2012-10-17作为版本号，你当前配置中写的2017是无效的。这个语法错误会导致Serverless框架无法正确解析角色定义，进而不将该资源写入最终的CloudFormation模板。

修正serverless.yml中角色的版本字段：

Resources:
  doStuffFromInsideVPC:
    Type: "AWS::IAM::Role"
    Properties:
      AssumeRolePolicyDocument:
        Version: '2012-10-17'  # 替换原来的2017
        Statement:
          - Effect: Allow
            Principal:
              Service:
                - lambda.amazonaws.com
            Action: sts:AssumeRole
      Policies:
        - PolicyName: doStuffFromInsideVPCPolicy
          PolicyDocument:
            Version: '2012-10-17'  # 替换原来的2017
            Statement:
              - Effect: Allow
                Action:
                  - logs:CreateLogGroup
                  - logs:CreateLogStream
                  - logs:PutLogEvents
                Resource:
                  - 'Fn::Join':
                      - ':'
                      - - 'arn:aws:logs'
                        - Ref: 'AWS::Region'
                        - Ref: 'AWS::AccountId'
                        - 'log-group:/aws/lambda/*:*:*'
              - Effect: Allow
                Action:
                  - ec2:CreateNetworkInterface
                  - ec2:DescribeNetworkInterfaces
                  - ec2:DetachNetworkInterface
                  - ec2:DeleteNetworkInterface
                Resource: "*"

2. 清理冗余配置，避免冲突 #

你在provider级别定义了iamRoleStatements，但同时又为函数指定了自定义角色。当使用自定义角色时，Serverless会忽略provider级别的默认角色配置，这部分冗余代码可能造成混淆，建议删除：

# 移除provider下的这段配置
iamRoleStatements:
  - Effect: Allow
    Action:
      - "S3:*"
    Resource: arn:aws:s3:::*
  - Effect: Allow
    Action:
      - "rds:*"
    Resource: "*"

如果你的Lambda需要S3和RDS权限，直接将这些权限添加到自定义角色的Policies中即可。

3. 优化角色引用方式 #

在函数配置中，你可以直接使用Ref来获取角色的ARN（IAM::Role资源的Ref返回值就是ARN），比Fn::GetAtt更简洁：

functions:
  writeToDB:
    handler: write-users-to-rds.writeToDB
    events:
      - sns: userlists
    role:
      Ref: doStuffFromInsideVPC  # 替换原来的Fn::GetAtt

4. 清理缓存并重新部署 #

删除本地的.serverless目录（这是Serverless生成的临时缓存文件），然后重新运行：

rm -rf .serverless
serverless deploy

部署完成后，再次检查生成的cloudformation-template-update-stack.json，确认doStuffFromInsideVPC已经出现在Resources列表中。

5. 额外排查点（如果上述步骤无效） #

• 插件干扰：暂时禁用serverless-plugin-typescript插件，重新部署测试，看是否是插件导致资源渲染异常。
• Serverless版本：升级Serverless到最新稳定版，旧版本可能存在资源渲染的Bug：

  npm install -g serverless@latest
  

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