使用SAM模板Makefile构建时无法安装Python依赖库求助

核心问题 #

切换到BuildMethod: makefile后，需手动确保函数代码和依赖包处于同一目录层级。Lambda运行时仅会将函数代码根目录（即$(ARTIFACT_DIR)）加入Python模块搜索路径，你之前尝试的pip安装路径要么层级过深，要么存在拼写错误，导致无法找到pydantic等依赖。

正确的Makefile配置 #

在hello_world/Makefile中写入以下内容，确保代码和依赖都被放到$(ARTIFACT_DIR)根目录：

build-HelloWorldFunction:
	mkdir -p $(ARTIFACT_DIR)
	# 复制函数代码到构建产物目录
	cp app.py $(ARTIFACT_DIR)
	# 安装依赖到构建产物目录，--no-cache-dir避免缓存问题
	python3.10 -m pip install -r requirements.txt -t $(ARTIFACT_DIR) --no-cache-dir

关键说明 #

• 必须显式复制app.py到$(ARTIFACT_DIR)：默认Python构建方法会自动处理代码复制，但Makefile模式下需手动完成。
• 指定python3.10版本：确保和Lambda Runtime（python3.10）一致，避免依赖编译版本不兼容。
• 直接安装到$(ARTIFACT_DIR)：Lambda运行时会自动扫描该目录下的模块，无需额外配置路径。

验证步骤 #

1. 清理之前的构建缓存，避免旧产物干扰：

sam build --clean

2. 若依赖包含需要编译的包（如psycopg2-binary），建议用容器构建以匹配Lambda环境：

sam build --use-container --clean

3. 本地测试函数是否能正常运行：

sam local invoke HelloWorldFunction

为什么之前的命令失败 #

• python -m pip install -r requirements.txt -t $(ARTIFACT_DIR)/python：Lambda默认不会将/var/task/python加入模块搜索路径，除非在app.py中手动添加sys.path.insert(0, '/var/task/python')，但这不是推荐做法。
• python -m pip install -r requirements.txt -t $(ARTIFACT_DIR)/python/lib/python3.10/site-packes：路径拼写错误（site-packes应为site-packages），且层级过深，Lambda无法自动识别该路径下的模块。

内容的提问来源于stack exchange，提问作者A H Bensiali