AWS SAM中CodeUri与Handler配置一致性问题咨询

核心问题根源 #

你遇到的问题本质是SAM模板中CodeUri的作用域、打包逻辑差异，以及跨环境部署方式不一致导致的：

1. CodeUri作用域冲突：仅为第一个函数设置CodeUri: src/时，该函数的打包根目录为src/，但后续未设置CodeUri的函数会默认使用模板所在的项目根目录作为CodeUri，此时Handler必须带上src.前缀才能定位到代码文件。
2. 跨环境部署方式差异：如果同事的环境使用容器镜像部署而非传统Zip包部署，SAM对CodeUri的解析逻辑完全不同——镜像模式下CodeUri指向Dockerfile所在目录，而非代码目录，导致原Zip包的CodeUri配置失效。
3. 相对路径依赖工作目录：代码中硬编码的相对路径依赖Lambda运行时的工作目录，而CodeUri的配置直接决定了工作目录，一旦配置不一致就会出现路径找不到的问题。

统一配置的解决方案 #

1. 全局统一CodeUri配置（Zip包部署场景）

在模板的Globals段定义所有函数共享的CodeUri，避免逐个函数重复配置，确保所有函数的打包根目录一致：

Globals:
  Function:
    CodeUri: src/
    Runtime: python3.11  # 根据实际运行时调整
    Timeout: 10

Resources:
  GetCategoriesFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: api/categories/app.lambda_handler  # 相对于src/的路径
      Events:
        GetCategories:
          Type: Api
          Properties:
            Path: /categories
            Method: get

  CreateItemFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: api/items/app.lambda_handler  # 同样使用相对src/的路径
      Events:
        CreateItem:
          Type: Api
          Properties:
            Path: /items
            Method: post

此时所有函数的运行时工作目录都是src/，代码中访问文件可以直接用./lib/categories/all.json。

2. 消除相对路径依赖（通用优化）

为彻底避免工作目录变化导致的路径问题，代码中用动态路径获取文件位置：

import os

# 获取当前脚本所在目录，再拼接目标文件路径
FILE_PATH = os.path.join(os.path.dirname(__file__), "../lib/categories/all.json")

def lambda_handler(event, context):
    with open(FILE_PATH, "r") as f:
        data = f.read()
    # 后续逻辑

这种方式不依赖运行时的工作目录，无论CodeUri如何配置都能正确找到文件。

3. 跨环境一致性保障

• 统一SAM CLI版本：团队成员使用相同版本的SAM CLI（通过sam --version查看），不同版本对CodeUri的解析逻辑可能存在差异。
• 统一部署方式：如果团队同时存在Zip包和容器镜像部署，必须分开配置：
  • 镜像部署场景：CodeUri指向包含Dockerfile的目录，Handler路径基于镜像内的工作目录（比如Dockerfile中指定WORKDIR /app，则Handler为src/api/app.lambda_handler）。
  • 统一使用sam build --use-container打包：确保打包环境一致，避免本地依赖与部署环境的差异。

4. 排查模板中的配置冲突

检查模板中是否存在以下情况：

• 部分函数显式设置了CodeUri，部分未设置，导致打包根目录不一致。
• 全局Globals和函数级的CodeUri重复定义，函数级配置会覆盖全局，引发混乱。

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