Docker Lambda镜像启动报错：无法找到AWSLambda主类

用户构建Docker Lambda镜像的Dockerfile如下：

FROM registry.access.redhat.com/ubi8/ubi:8.1 as base

RUN yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
RUN yum update -y
RUN yum install -y sudo bash curl wget man-db nano bash-completion
RUN yum install -y java-11-openjdk-devel
RUN java -version


ENTRYPOINT [ "/usr/bin/java", "-cp", "./*", "com.amazonaws.services.lambda.runtime.api.client.AWSLambda" ]
CMD ["optimizerMarsExecutor.OptimizerMarsExecutorFunction::handleRequest"]

构建镜像并运行：

docker run -p 9000:8080 mars-console-linux-image
curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{"payload":"hello world!"}'

执行后报错：

Error: Could not find or load main class com.amazonaws.services.lambda.runtime.api.client.AWSLambda
Caused by: java.lang.ClassNotFoundException: com.amazonaws.services.lambda.runtime.api.client.AWSLambda

核心问题 #

你遗漏了两个关键配置：

1. 缺少AWS Lambda Java运行时接口客户端（RIC）依赖：com.amazonaws.services.lambda.runtime.api.client.AWSLambda是RIC中的核心类，你的镜像中没有包含这个JAR包。
2. 未将自定义Lambda函数代码放入镜像：CMD指定的处理类optimizerMarsExecutor.OptimizerMarsExecutorFunction也不存在于镜像中，即使RIC依赖到位，后续也会报该类找不到的错误。

具体修复步骤 #

1. 为项目添加RIC依赖

如果用Maven管理项目，在pom.xml中添加依赖（版本建议使用最新稳定版）：

<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-lambda-java-runtime-interface-client</artifactId>
    <version>2.3.1</version>
</dependency>

如果用Gradle，添加到build.gradle：

implementation 'com.amazonaws:aws-lambda-java-runtime-interface-client:2.3.1'

2. 修改Dockerfile为多阶段构建

采用多阶段构建可以避免将构建工具（如Maven）打包到最终镜像，同时确保依赖和代码被正确复制：

# 第一阶段：编译代码并打包（包含所有依赖）
FROM maven:3.8.6-openjdk-11 as builder
WORKDIR /app
# 复制项目配置和源码
COPY pom.xml .
COPY src ./src
# 打包成包含所有依赖的JAR
RUN mvn package -DskipTests

# 第二阶段：构建运行镜像
FROM registry.access.redhat.com/ubi8/ubi:8.1
# 安装JDK并清理缓存减小镜像体积
RUN yum install -y java-11-openjdk-devel && yum clean all && rm -rf /var/cache/yum
WORKDIR /function
# 从构建阶段复制打包好的JAR
COPY --from=builder /app/target/your-function-jar-with-dependencies.jar .
# 设置入口点：指定RIC主类，类路径覆盖当前目录下所有JAR
ENTRYPOINT [ "/usr/bin/java", "-cp", "/function/*", "com.amazonaws.services.lambda.runtime.api.client.AWSLambda" ]
# 指定自定义处理类
CMD ["optimizerMarsExecutor.OptimizerMarsExecutorFunction::handleRequest"]

注意：将your-function-jar-with-dependencies.jar替换为你实际打包生成的JAR文件名。

3. 重新构建并运行镜像

执行以下命令：

docker build -t mars-console-linux-image .
docker run -p 9000:8080 mars-console-linux-image

之后再用curl调用即可正常执行。

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