AWS Lambda Python 包缺失解决方法

本文揭示了使用 AWS SAM 部署 Python Lambda 函数时一个隐蔽却高频的陷阱：显式在 `sam deploy` 中指定 `--template-file` 参数会意外绕过 SAM 的自动构建产物引用机制，导致 `requirements.txt` 中声明的依赖（如 pytest）未被打包上传，运行时直接抛出 `ModuleNotFoundError`；文章不仅精准定位根本原因——原始模板未被构建后增强版模板替代，还给出了即学即用的解决方案：仅在 `sam build` 时指定模板，让 `sam deploy` 自动加载 `.aws-sam/build/template.yaml`，并进一步提醒读者区分开发依赖与运行时依赖，倡导将 pytest 等测试工具移出生产 `requirements.txt`，从而提升部署可靠性、减小包体积、优化冷启动性能。

使用 AWS SAM 部署 Lambda 函数时，若通过 sam deploy --template-file 显式指定模板文件，会导致依赖包（如 requirements.txt 中声明的 pytest）未被正确打包上传，从而在运行时抛出 ModuleNotFoundError。根本原因在于该参数绕过了 SAM 的自动构建产物引用机制。

使用 AWS SAM 部署 Lambda 函数时，若通过 `sam deploy --template-file` 显式指定模板文件，会导致依赖包（如 requirements.txt 中声明的 pytest）未被正确打包上传，从而在运行时抛出 `ModuleNotFoundError`。根本原因在于该参数绕过了 SAM 的自动构建产物引用机制。

在基于 AWS SAM 构建和部署 Python Lambda 函数时，一个常见但容易被忽视的陷阱是：显式传递 --template-file 参数给 sam deploy 命令，会中断 SAM 对构建产物（.aws-sam/build/）的自动识别与注入流程。即使你已成功执行 sam build 并确认 pytest 等依赖已正确安装到本地构建目录中，sam deploy --template-file template.yaml 仍会跳过对构建后资源的引用，转而直接读取原始模板（即未包含 vendor 包的源 template.yaml），最终导致 Lambda 运行环境缺少所需模块。

✅ 正确做法是：仅在 sam build 阶段指定 --template-file，而在 sam deploy 阶段完全省略该参数。SAM 会自动从默认构建输出路径（.aws-sam/build/template.yaml）加载已注入依赖的更新后模板：

# ✅ 正确：build 指定模板，deploy 由 SAM 自动选择构建后的模板
sam build --template-file template.yaml
sam deploy --config-env dev --profile awsprofile

⚠️ 注意事项：

• sam deploy 默认查找并使用 .aws-sam/build/template.yaml —— 这是 sam build 执行后生成的、已将 requirements.txt 中所有依赖打包进函数代码目录的增强版模板；
• 若强制用 --template-file template.yaml，SAM 将忽略构建产物，回退到原始模板，导致部署的仍是“空依赖”的函数代码；
• 可通过检查 .aws-sam/build// 目录确认依赖是否已解压（例如是否存在 pytest/ 子目录及 pytest/__init__.py）；
• 如需统一配置，建议在 samconfig.toml 中声明 template = "template.yaml"，后续所有 sam build 和 sam deploy 均无需重复指定，提升可维护性。

? 补充建议：
pytest 本身并不适合在 Lambda 运行时环境中直接导入（它属于开发/测试工具，非运行时依赖）。生产函数应避免引入此类包；若仅为本地单元测试，请确保 pytest 仅出现在 requirements-dev.txt 中，并在 sam build 时通过 --use-container 或自定义构建脚本排除——真正上线的 requirements.txt 应只包含运行时必需的轻量级依赖（如 requests, boto3 等）。这既是最佳实践，也能显著减小部署包体积、缩短冷启动时间。

本篇关于《AWS Lambda Python 包缺失解决方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！