Spring Boot 2.7.17迁移启动报错：IllegalStateException问题解决

数据老陈

2026-7-4

解决Spring Boot 2.7.17启动时WebMvcMetricsAutoConfiguration相关的ArrayStoreException错误

以下是几种常见的排查和解决方法：

检查Actuator依赖完整性
WebMvcMetricsAutoConfiguration属于Spring Boot Actuator模块，若依赖缺失或不完整会触发类加载异常。确保项目中引入完整的Actuator starter：
Maven配置：
```
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
```
Gradle配置：
```
implementation 'org.springframework.boot:spring-boot-starter-actuator'
```
避免单独引入metrics相关零散依赖，用starter统一管理版本，减少冲突概率。
确认Web MVC依赖存在
WebMvcMetricsAutoConfiguration依赖WebMvc环境，若项目是Servlet栈，需确保引入spring-boot-starter-web：
Maven配置：
```
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
```
若为WebFlux项目，该自动配置会自动跳过，无需额外操作。
清理缓存并重新构建
执行以下命令清除旧编译文件和依赖缓存，避免缓存导致的类加载异常：
Maven：mvn clean install
Gradle：./gradlew clean build
同时重启IDE并同步依赖，确保依赖正确加载。
排查自定义配置中的无效类引用
TypenotPresentExceptionProxy通常表示代码中引用了不存在的类。检查项目中与Metrics、Actuator相关的自定义配置类、注解，确认是否有指向已删除或未引入的类路径（比如注解属性值引用了不存在的Metrics类），修正这类无效引用。
解决依赖版本冲突
用依赖树命令排查版本不一致的问题：
Maven：mvn dependency:tree
Gradle：./gradlew dependencies
重点查看spring-metrics、spring-actuator、spring-web相关依赖，确保版本与Spring Boot 2.7.17一致。若发现第三方依赖引入了冲突版本，通过<exclusions>（Maven）或exclude（Gradle）排除冲突依赖。