AWS CDK Python部署Lambda Layer遇导入错误，手动上传正常

核心差异原因推测 #

手动上传与CDK部署的核心差异在于CDK对资产文件的处理逻辑：当使用_lambda.Code.from_asset指向本地zip文件时，CDK会将该文件作为资产上传到S3，但如果存在以下情况，会导致最终部署到Lambda的Layer结构异常：

• CDK在处理资产时意外添加了额外的目录层级
• 本地zip包的路径存在特殊字符/相对路径解析问题，导致CDK上传的文件与本地不一致
• 部分压缩格式（如Windows下生成的带额外元数据的zip）被CDK处理后结构变形

排查步骤 #

1. 验证CDK上传的实际zip包结构 #

• 登录AWS控制台，找到CDK自动创建的S3资产桶（命名格式通常为cdk-assets-<账号ID>-<区域>）
• 在桶内找到对应Layer的zip文件（可通过CDK部署日志中的资产路径定位）
• 下载该zip并解压，对比本地原zip的目录结构：确认根目录是否直接为python文件夹，内部层级是否为python/lib/python3.11/site-packages/且包含所需依赖

2. 检查Lambda Layer的实际挂载结构 #

• 在AWS控制台打开CDK部署的Layer，进入「内容」标签页，查看解压后的目录树
• 同时，在依赖该Layer的Lambda函数中添加调试代码，执行后查看日志：

  import sys
  import os
  
  print("sys.path:", sys.path)
  print("/opt目录内容:", os.listdir('/opt'))
  

  确认/opt/python/lib/python3.11/site-packages是否存在，且是否被加入sys.path

3. 排查CDK资产处理逻辑 #

• 检查本地zip文件的路径是否包含空格、中文或特殊字符，尝试将zip文件移动到无特殊字符的路径后重新部署
• 若本地zip是通过Windows系统生成的，尝试用Linux/macOS的zip命令重新打包（避免Windows元数据干扰）：

  cd python/
  zip -r ../layer.zip .
  

• 确认CDK配置中未使用额外的资产打包逻辑（若误加会导致重新打包破坏原有结构）

4. 验证Layer与Lambda的运行时匹配 #

• 再次确认Lambda函数的运行时（需与Layer指定的PYTHON_3_11完全一致）
• 检查Lambda函数的「配置」→「环境变量」中是否存在PYTHONPATH自定义配置，若有需确保未覆盖Layer的默认路径

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