@RestControllerAdvice+@ExceptionHandler返回data class无JSON响应求助

问题原因分析 #

触发异常时仅返回状态码但响应体为空，核心原因集中在ApiError的序列化问题：

1. 缺少无参构造函数：Kotlin data class若所有构造参数无默认值，不会自动生成无参构造，而Spring的Jackson消息转换器需要无参构造来完成序列化操作。
2. 缺失Kotlin反射依赖：Jackson处理Kotlin类依赖kotlin-reflect，若未引入该依赖，无法正确识别data class的属性信息。
3. 属性访问权限限制：若手动将data class的属性设为private，Jackson无法读取属性值导致序列化后为空对象。

解决步骤与Kotlin风格实现 #

1. 修正ApiError data class #

给构造参数添加默认值，自动生成无参构造，同时保留Kotlin简洁特性：

import java.time.LocalDateTime

data class ApiError(
    val status: Int = 500,
    val message: String = "服务器内部错误",
    val timestamp: LocalDateTime = LocalDateTime.now()
)

2. 确保依赖完整性 #

在build.gradle.kts中显式声明必要依赖（Spring Boot3部分依赖已自动引入，但显式声明更稳妥）：

dependencies {
    implementation("org.springframework.boot:spring-boot-starter-web")
    implementation("com.fasterxml.jackson.module:jackson-module-kotlin")
    implementation("org.jetbrains.kotlin:kotlin-reflect")
}

3. 配置Spring Boot抛出404异常 #

在application.properties中添加配置，让Spring Boot抛出NoHandlerFoundException以便全局捕获：

spring.mvc.throw-exception-if-no-handler-found=true
spring.web.resources.add-mappings=false

4. Kotlin风格全局异常处理类 #

利用Kotlin的空安全、lambda简化等特性，实现简洁且覆盖全面的全局异常处理：

import org.springframework.http.HttpStatus
import org.springframework.http.ResponseEntity
import org.springframework.web.HttpRequestMethodNotSupportedException
import org.springframework.web.bind.annotation.ExceptionHandler
import org.springframework.web.bind.annotation.RestControllerAdvice
import org.springframework.web.servlet.NoHandlerFoundException

@RestControllerAdvice
class GlobalExceptionHandler {

    // 处理404路径不存在异常
    @ExceptionHandler(NoHandlerFoundException::class)
    fun handleNotFound(ex: NoHandlerFoundException): ResponseEntity<ApiError> {
        val error = ApiError(
            status = HttpStatus.NOT_FOUND.value(),
            message = "请求路径不存在: ${ex.requestURL}"
        )
        return ResponseEntity(error, HttpStatus.NOT_FOUND)
    }

    // 处理405请求方法不允许异常
    @ExceptionHandler(HttpRequestMethodNotSupportedException::class)
    fun handleMethodNotAllowed(ex: HttpRequestMethodNotSupportedException): ResponseEntity<ApiError> {
        val allowedMethods = ex.supportedHttpMethods?.joinToString(", ") ?: "无"
        val error = ApiError(
            status = HttpStatus.METHOD_NOT_ALLOWED.value(),
            message = "不支持的请求方法: ${ex.method}，允许方法: $allowedMethods"
        )
        return ResponseEntity(error, HttpStatus.METHOD_NOT_ALLOWED)
    }

    // 兜底处理所有未捕获异常
    @ExceptionHandler(Exception::class)
    fun handleGenericException(ex: Exception): ResponseEntity<ApiError> {
        val error = ApiError(
            message = ex.message ?: "未知错误"
        )
        return ResponseEntity(error, HttpStatus.INTERNAL_SERVER_ERROR)
    }
}

可选优化：用密封类统一管理自定义异常 #

如果有自定义业务异常，可利用Kotlin密封类实现类型安全的异常处理：

// 密封类定义业务异常
sealed class BusinessException(open val message: String) : RuntimeException(message) {
    data class UserNotFoundException(override val message: String) : BusinessException(message)
    data class InvalidRequestException(override val message: String) : BusinessException(message)
}

// 在全局异常处理类中添加处理方法
@ExceptionHandler(BusinessException::class)
fun handleBusinessException(ex: BusinessException): ResponseEntity<ApiError> {
    val status = when(ex) {
        is BusinessException.UserNotFoundException -> HttpStatus.NOT_FOUND
        is BusinessException.InvalidRequestException -> HttpStatus.BAD_REQUEST
    }
    val error = ApiError(
        status = status.value(),
        message = ex.message
    )
    return ResponseEntity(error, status)
}

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