Spring 2.6.5升级至3.1.0后HttpStatusCode实例化错误求助

问题描述 #

将Spring从2.6.5版本升级到3.1.0后，执行测试代码时触发InstantiationError: org.springframework.http.HttpStatusCode异常。测试中尝试设置mockExchange.response.statusCode为HttpStatus.OK时报错，即使改用HttpStatusCode.valueOf(200)也无法解决该问题。

测试代码 #

import org.springframework.http.HttpStatus
import org.springframework.http.HttpStatus.OK
import org.springframework.http.HttpStatusCode
import org.springframework.web.server.ServerWebExchange

@Test
fun `and the operation is successful it should create and emit the audit event`() {
    private val mockExchange = mockk<ServerWebExchange>()
    every { mockExchange.authorizationData() } returns null
    every { mockExchange.response.statusCode } returns HttpStatus.OK

    mockSuccessfulFilterOperations()

    assertDoesNotThrow {
        auditLoggerFilter.filter(mockExchange, mockChain).block()
    }

    verify(exactly = 1) { auditLoggerService.publishAuditEvent(any(), SUCCESS) }
    confirmVerified(auditLoggerService)
}

抛出异常 #

org.springframework.http.HttpStatusCode
java.lang.InstantiationError: org.springframework.http.HttpStatusCode

原因分析 #

InstantiationError本质是JVM无法实例化目标类型，结合Spring版本升级背景，核心原因包括：

1. 依赖版本冲突：项目中残留Spring 2.x版本的spring-web或相关依赖，Spring 3.x中HttpStatusCode已改为接口，而2.x版本中是抽象类，类定义不一致导致加载异常。
2. Mockk版本不兼容：旧版本Mockk对Spring 3.x的接口类型属性mock支持存在缺陷，无法正确处理HttpStatusCode接口的返回值设置逻辑。
3. Mock方式不当：直接mockexchange.response.statusCode这类嵌套属性时，Mockk未正确初始化中间的ServerHttpResponse对象，触发接口实例化失败。

解决方案 #

1. 清理依赖冲突
   检查项目依赖树，确保所有Spring相关依赖（尤其是spring-web）统一升级到3.1.0版本，排除旧版本依赖：

   • Maven执行命令：mvn dependency:tree
   • Gradle执行命令：./gradlew dependencies
     找到冲突依赖后，在构建脚本中显式排除旧版本。

2. 升级Mockk版本
   将Mockk升级到1.13.8及以上版本，新版本优化了接口类型的mock逻辑，可适配Spring 3.x的类型变化。

3. 调整Mock逻辑
   避免直接mock嵌套属性，先单独mockServerHttpResponse对象再关联到ServerWebExchange：

   @Test
   fun `and the operation is successful it should create and emit the audit event`() {
       val mockResponse = mockk<ServerHttpResponse>()
       val mockExchange = mockk<ServerWebExchange>()
       
       every { mockExchange.authorizationData() } returns null
       every { mockExchange.response } returns mockResponse
       every { mockResponse.statusCode } returns HttpStatus.OK
   
       mockSuccessfulFilterOperations()
   
       assertDoesNotThrow {
           auditLoggerFilter.filter(mockExchange, mockChain).block()
       }
   
       verify(exactly = 1) { auditLoggerService.publishAuditEvent(any(), SUCCESS) }
       confirmVerified(auditLoggerService)
   }
   

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