如何将现有Lambda层添加至Amplify Gen 2函数？

问题描述 #

我需要把AWS控制台中已部署的、来自其他项目的Lambda层，关联到Amplify Gen 2的函数里。官方文档没找到相关方法，尝试了一些参考内容，但那些示例都是用本地层路径或自定义类，不符合我的场景——层代码在其他仓库，没法用本地路径，也不知道怎么在Amplify后端代码里适配那些类。

我尝试了以下代码来添加层：

import { defineBackend } from '@aws-amplify/backend'
import { auth } from './auth/resource'
import { data } from './data/resource'
import { myFunc} from './functions/MyFunc/resource'
import * as lambda from 'aws-cdk-lib/aws-lambda'
import { Stack } from 'aws-cdk-lib'

const backend = defineBackend({
  auth,
  data,
  myFunc,
})

const myFuncLambda = backend.myFunc.resources.lambda as lambda.Function

const layerVersion = lambda.LayerVersion.fromLayerVersionArn(
  Stack.of(myFuncLambda),
  'myFuncLayer',
  'arn:aws:lambda:{AWS::REGION}:{AWS::ACCOUNTID}:layer:{AWS::LAYERVERSION}'
)

myFuncLambda.addLayers(layerVersion)

部署时出现报错：

NodeJSFunctionConstructInitializationError: Failed to instantiate nodejs function construct

解决方法 #

问题出在直接强制类型转换Amplify生成的Lambda实例并修改，Amplify Gen 2的函数是基于NodeJSFunction构造的，直接调用addLayers会干扰其初始化流程。推荐两种可行的实现方式：

方式一：在函数定义文件中直接配置层 #

打开./functions/MyFunc/resource.ts，通过cdk.function.layers属性关联现有层：

import { defineFunction } from '@aws-amplify/backend';
import * as lambda from 'aws-cdk-lib/aws-lambda';

export const myFunc = defineFunction({
  name: 'myFunc',
  // 保留你的函数其他配置（如entry、runtime等）
  cdk: {
    function: {
      layers: [
        lambda.LayerVersion.fromLayerVersionArn(
          this.stack,
          'myFuncLayer',
          `arn:aws:lambda:${this.stack.region}:${this.stack.account}:layer:你的层名称:版本号`
        )
      ]
    }
  }
});

方式二：在backend.ts中全局修改 #

避免强制类型转换，直接使用函数实例的stack属性来获取栈信息：

import { defineBackend } from '@aws-amplify/backend';
import { auth } from './auth/resource';
import { data } from './data/resource';
import { myFunc} from './functions/MyFunc/resource';
import * as lambda from 'aws-cdk-lib/aws-lambda';

const backend = defineBackend({
  auth,
  data,
  myFunc,
});

const funcStack = backend.myFunc.resources.lambda.stack;
const layerArn = `arn:aws:lambda:${funcStack.region}:${funcStack.account}:layer:你的层名称:版本号`;

backend.myFunc.resources.lambda.addLayers(
  lambda.LayerVersion.fromLayerVersionArn(
    funcStack,
    'myFuncLayer',
    layerArn
  )
);

关键注意事项 #

• 替换占位符：确保层ARN中的区域、账号ID、层名称和版本号是实际的AWS资源信息，不要使用{AWS::REGION}这类CloudFormation伪参数，可通过stack.region和stack.account动态获取当前环境的区域和账号。
• 运行时匹配：Lambda层的运行时必须与Amplify函数的运行时保持一致（比如都是Node.js 18.x），否则会导致部署失败。

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