Spring Boot项目本地可运行，Docker容器启动报错找不到主类

本地执行mvn spring-boot:run可以正常编译运行Spring Boot项目，但制作Docker容器启动时出现以下报错：

Failed to execute goal org.springframework.boot:spring-boot-maven-plugin:3.4.1:start (default-cli) on project FlipTheBook: Unable to find a suitable main class, please add a 'mainClass' property

项目架构：

相关文件内容 #

Dockerfile #

FROM docker.io/maven:3.9.9-eclipse-temurin-23-alpine

COPY ./* ./FlipTheBook/

WORKDIR FlipTheBook

ENTRYPOINT mvn spring-boot:start

pom.xml #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.1</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.FlipTheBook</groupId>
    <artifactId>FlipTheBook</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>FlipTheBook</name>
    <description>Flip Book Creator Application</description>
    <url/>
    <licenses>
        <license/>
    </licenses>
    <developers>
        <developer/>
    </developers>
    <scm>
        <connection/>
        <developerConnection/>
        <tag/>
        <url/>
    </scm>
    <properties>
        <java.version>21</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

解决方法 #

1. 修复Dockerfile的COPY命令 #

当前COPY ./* ./FlipTheBook/只会复制根目录下的文件，不会递归复制src/等子目录，导致容器内缺少源代码，Maven找不到主类。修改为：

COPY . ./FlipTheBook/

2. 采用标准的Spring Boot Docker构建方式（推荐） #

用mvn spring-boot:start在容器内实时编译运行不是生产环境的最优方案，建议先打包成Jar包再构建镜像，推荐使用多阶段构建：

# 构建阶段：打包Jar包
FROM maven:3.9.9-eclipse-temurin-21-alpine AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline  # 提前下载依赖，加快构建速度
COPY src ./src
RUN mvn package -DskipTests  # 打包Jar包，跳过测试

# 运行阶段：仅运行Jar包
FROM eclipse-temurin:21-alpine
WORKDIR /app
COPY --from=builder /app/target/FlipTheBook-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java", "-jar", "app.jar"]

注意：使用和项目pom.xml一致的Java 21版本，避免版本不兼容问题。

3. 手动指定主类（如果坚持用mvn spring-boot:start） #

在pom.xml的Spring Boot Maven插件中明确指定主类（替换成你实际的主类全路径，比如com.FlipTheBook.FlipTheBookApplication）：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>com.FlipTheBook.FlipTheBookApplication</mainClass>
            </configuration>
        </plugin>
    </plugins>
</build>

修改后确保Dockerfile的COPY命令正确复制所有文件。

4. 统一Java版本 #

项目pom.xml指定Java版本为21，但Docker镜像用的是temurin-23，版本不匹配可能引发潜在问题，建议将Docker镜像改为maven:3.9.9-eclipse-temurin-21-alpine。

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