Spring Boot与Spring Cloud升级后出现NoClassDefFoundError问题求助

一、定位依赖归属 #

org.springframework.cloud.util.PropertyUtils类属于spring-cloud-commons模块，在你使用的Spring Cloud 3.1.5（对应2021.0.5版本，代号Jubilee）中，该类就包含在这个模块里。

二、检查并添加依赖 #

Maven项目 #

• 若未引入Spring Cloud依赖管理，直接添加带版本的依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-commons</artifactId>
    <version>3.1.5</version>
</dependency>

• 若已引入Spring Cloud依赖管理（推荐），只需添加依赖无需指定版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2021.0.5</version> <!-- 对应Spring Cloud 3.1.5 -->
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-commons</artifactId>
    </dependency>
</dependencies>

Gradle项目 #

• 直接添加依赖：

implementation 'org.springframework.cloud:spring-cloud-commons:3.1.5'

• 若已引入Spring Cloud依赖管理，可省略版本号：

dependencyManagement {
    imports {
        mavenBom "org.springframework.cloud:spring-cloud-dependencies:2021.0.5"
    }
}

dependencies {
    implementation 'org.springframework.cloud:spring-cloud-commons'
}

三、验证依赖是否生效 #

• Maven项目执行命令查看依赖树，确认spring-cloud-commons已被引入：

mvn dependency:tree | grep spring-cloud-commons

• Gradle项目执行命令验证：

gradle dependencies | grep spring-cloud-commons

如果输出中能看到该依赖的信息，说明已正确引入；若没有，检查依赖管理配置是否正确，或是否有其他依赖主动排除了spring-cloud-commons。

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