本地Docker容器中运行.NET 7 AWS Lambda的入口点配置问题

我尝试在本地Docker容器中运行.NET 7 AWS Lambda，但遇到了入口点配置的问题。网上关于Python或JS Lambda的本地运行资料很多，但.NET相关的内容很少，我无法正确指定Lambda的入口点。

我使用的Dockerfile如下：

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build-env
WORKDIR /App

# Copy everything
COPY . ./
# Restore as distinct layers
RUN dotnet restore
# Build and publish a release
RUN dotnet publish -p:PublishReadyToRun=false -c Release -o out

# Build runtime image
FROM mcr.microsoft.com/dotnet/aspnet:7.0
WORKDIR /App
COPY --from=build-env /App/out .
ENTRYPOINT ["dotnet", "LambdaLocal.dll"]

（该Dockerfile参考了控制台应用的构建文档，但我的是Lambda项目）

执行的Docker命令：

docker build -t local-lambda-image -f Dockerfile .

然后运行容器：

docker run --rm -p 9000:8080 --name local-lamba-cont local-lambda-image

运行时出现错误：

Unhandled exception. System.MissingMethodException: Entry point not found in assembly 'LambdaLocal, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null'.

我还尝试了Stack Overflow上的建议命令：

docker run -p 9000:8080 --name local-lambda-container local-lambda-image "LambdaLocal::LambdaLocal.Function::FunctionHandler"

但仍然出现相同的错误。请问该如何为.NET Lambda正确指定入口点？

解决方案 #

1. 改用AWS Lambda专用的.NET基础镜像 #

普通的aspnet:7.0镜像不是为Lambda设计的，Lambda需要特定的运行时环境来处理事件请求。你应该使用AWS官方提供的.NET Lambda镜像：

• 构建阶段用public.ecr.aws/sam/build-dotnet7:latest
• 运行阶段用public.ecr.aws/lambda/dotnet:7

修改后的Dockerfile示例：

# 构建阶段
FROM public.ecr.aws/sam/build-dotnet7:latest AS build-env
WORKDIR /src

COPY *.csproj ./
RUN dotnet restore

COPY . ./
RUN dotnet publish -c Release -o /app/publish

# 运行阶段
FROM public.ecr.aws/lambda/dotnet:7
WORKDIR /var/task
COPY --from=build-env /app/publish .

2. 正确指定Lambda入口点 #

AWS Lambda的.NET运行时可自动识别入口点，若需显式指定，可通过两种方式：

• 环境变量方式：运行容器时添加入口点参数

  docker run --rm -p 9000:8080 -e AWS_LAMBDA_FUNCTION_HANDLER="LambdaLocal::LambdaLocal.Function::FunctionHandler" --name local-lamba-cont local-lambda-image
  

• Dockerfile配置：在运行阶段添加CMD指令

  # 运行阶段末尾添加
  CMD ["LambdaLocal::LambdaLocal.Function::FunctionHandler"]
  

3. 验证Lambda项目结构 #

确保你的项目满足以下要求：

• 是通过AWS Lambda模板创建的项目（如Amazon.Lambda.Templates）
• Function类中存在FunctionHandler方法，签名符合Lambda要求（例如public string FunctionHandler(string input, ILambdaContext context)）
• 发布后的输出目录包含完整的程序集和依赖文件

4. 用AWS SAM CLI简化本地运行 #

如果不想手动配置Docker，推荐使用AWS SAM CLI：

1. 安装SAM CLI
2. 在项目根目录执行：

   sam build
   sam local start-lambda
   

SAM会自动处理镜像构建、入口点配置等流程，无需手动编写Dockerfile。

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