本地测试依赖Lambda Layer的Amplify Lambda函数时模块找不到

问题描述 #

我希望本地测试一个依赖Lambda Layer的Lambda函数，使用如下SAM模板：

AWSTemplateFormatVersion: '2010-09-09'
Transform: 'AWS::Serverless-2016-10-31'
Resources:
  MyLambdaFunction:
    Type: 'AWS::Serverless::Function'
    Properties:
      Handler: index.handler
      Runtime: python3.8
      CodeUri: pathToFunction
      Layers:
        - !Ref MyLayer

  MyLayer:
    Type: 'AWS::Serverless::LayerVersion'
    Properties:
      LayerName: mylayer
      Description: My Lambda layer for payment handling
      ContentUri: projectRoot/amplify/backend/function/myLambdaLayer
      CompatibleRuntimes:
        - python3.8

执行sam invoke local -e event.json MyLambdaFunction命令时，系统提示找不到Lambda Layer中的模块，但云端测试相同配置却能正常运行。

原因分析 #

• Layer本地目录结构不符合Python运行时要求：云端Lambda会自动将Layer内容挂载到/opt目录，Python运行时默认从/opt/python路径加载模块。但本地测试时，SAM直接读取你指定的ContentUri目录内容，如果你的Layer目录没有按python/子目录的结构存放模块，本地运行时就无法识别。比如云端打包的是python/your_module结构，但本地目录直接放置your_module，SAM本地不会自动调整路径结构。
• SAM本地未正确处理Layer依赖构建：云端部署时CloudFormation会自动完成Layer的依赖打包与路径整理，但本地测试时，若Layer需要第三方依赖（如通过requirements.txt声明），你未手动将依赖安装到正确路径，SAM不会自动执行依赖安装步骤，导致模块缺失。
• 相对路径解析偏差：模板中ContentUri使用了相对路径，而你执行sam invoke local的工作目录与模板预期的基准目录不一致，导致SAM无法正确读取Layer的文件内容。

解决办法 #

• 调整Layer目录结构：确保Layer根目录下存在python子目录，所有业务模块、第三方依赖都放在该python目录下，示例结构如下：

  myLambdaLayer/
  └── python/
      ├── your_module/
      │   └── __init__.py
      └── requests/          # 第三方依赖包
  

• 本地预构建Layer依赖：如果Layer需要第三方依赖，进入Layer的python目录，执行pip install -r requirements.txt -t .，将依赖包安装到正确路径后再执行本地调用。
• 确保路径解析正确：可以使用绝对路径作为ContentUri，或者切换到模板中相对路径的基准目录执行sam invoke local命令。也可以先执行sam build命令构建整个项目，再用sam invoke local --no-build调用，让SAM自动处理所有资源的路径映射。

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