在AWS ECS运行Corretto 8 Docker镜像时遇NoClassDefFoundError问题

问题分析 #

报错java.lang.NoClassDefFoundError: org/springframework/boot/context/properties/bind/Bindable说明运行时缺少Bindable类，该类属于Spring Boot核心模块。本地Docker运行正常但ECS异常，大概率是打包过程中依赖未正确包含，或是依赖版本不一致导致。

解决方案 #

1. 统一Spring Boot版本 #

确保pom.xml中所有Spring Boot相关依赖版本一致，避免混合不同版本的组件：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.15</version> <!-- 替换为你使用的稳定版本 -->
    <relativePath/>
</parent>

所有spring-boot-starter-*依赖无需手动指定版本，会继承父项目的版本。

2. 正确配置Spring Boot Maven插件 #

使用spring-boot-maven-plugin进行打包，确保所有依赖被打包进可执行WAR：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

执行mvn clean package后，生成的WAR是可执行的，包含所有运行必需的依赖。

3. 检查依赖范围 #

确保spring-boot-context-properties相关依赖未被标记为provided，否则运行时会缺失：

<!-- 错误示例：避免使用provided范围 -->
<!--
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-context-properties</artifactId>
    <scope>provided</scope>
</dependency>
-->

<!-- 正确配置：默认compile范围即可 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-oauth2-client</artifactId>
</dependency>

4. 验证WAR包完整性 #

解压本地生成的app.war，检查WEB-INF/lib目录下是否存在spring-boot-context-properties-*.jar文件。如果缺失，重新执行mvn clean package确保打包过程无报错。

5. 排查ECS任务配置 #

确认ECS任务定义中未设置CLASSPATH环境变量覆盖默认值，避免干扰Spring Boot的类路径加载逻辑。

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