Docker构建Spring Boot应用后出现ClassNotFoundException，Cloud Run部署失败

核心原因分析 #

这个错误本质是容器运行时找不到指定的主类字节码文件，常见原因集中在Docker构建流程未正确获取编译后的class文件，或是主类路径配置错误。

逐步排查方案 #

1. 检查Dockerfile是否正确处理编译产物 #

新手常犯的错误是直接复制源码到容器却不完成编译流程，或复制路径错误导致编译后的class文件未进入运行环境。推荐使用多阶段构建分离编译与运行环境：

# 构建阶段：用Maven完成编译打包
FROM maven:3.8.6-openjdk-11 AS builder
WORKDIR /app
COPY pom.xml .
COPY src ./src
RUN mvn clean package -DskipTests

# 运行阶段：仅复制编译好的可执行jar包
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=builder /app/target/*.jar app.jar
ENTRYPOINT ["java", "-jar", "app.jar"]

如果你的Dockerfile是在容器内直接编译，需确保：

• 容器已安装Maven环境
• 执行了mvn package命令且target目录生成了有效jar包
• 最终运行的是target目录下的jar，而非直接执行源码

2. 验证pom.xml的Spring Boot插件配置 #

Spring Boot项目必须配置spring-boot-maven-plugin才能生成包含主类清单和依赖的可执行jar，缺失该插件会导致运行时无法定位主类：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.7.14</version> <!-- 替换为你的Spring Boot对应版本 -->
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <!-- 明确指定主类路径，避免自动检测失败 -->
                <mainClass>com.example.MyDemoApplication</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

3. 确认GitHub Actions构建流程的完整性 #

• 确保Workflow中先执行mvn package完成编译，再启动Docker构建步骤
• 检查Docker构建上下文是否包含target目录（不要在.gitignore中忽略target，或在Workflow中先完成编译再传递构建上下文）

4. 本地验证镜像排除Cloud Run环境问题 #

在本地构建并运行镜像，判断问题是否出在构建环节：

# 本地构建镜像
docker build -t my-demo-app .
# 本地启动容器测试
docker run -p 8080:8080 my-demo-app

如果本地运行同样报错，说明问题出在Dockerfile或Maven配置；如果本地正常，再检查Cloud Run的部署启动命令是否正确。

关键注意点 #

• 运行阶段无需包含源码，仅需编译后的jar包，既减小镜像体积也避免依赖缺失
• 多阶段构建能隔离构建与运行环境，避免不必要的依赖污染
• 明确指定主类路径，避免Spring Boot自动检测主类时出现匹配错误

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