Kotlin Spring Boot Docker化应用响应缺失异常信息求助

你的代码中存在潜在冲突：同时使用@ResponseStatus注解和返回ResponseEntity对象，这会导致Spring在不同环境下的异常处理行为不一致。结合本地与Docker环境的差异，以下是具体排查和解决方向：

1. 统一异常响应的控制方式 #

移除@ResponseStatus注解，直接通过ResponseEntity完整定义响应内容。因为当返回ResponseEntity时，@ResponseStatus的reason参数在生产环境（Docker默认启动环境）中不会被Spring优先处理，而本地开发环境的宽松配置可能会兼容这种写法。修改后的代码如下：

@ExceptionHandler(DepartmentNotFoundException::class)
fun departmentNotFound(exception: DepartmentNotFoundException): ResponseEntity<String> {
    return ResponseEntity.status(HttpStatus.NOT_FOUND)
        .body("Department with this id not found!")
}

2. 检查Spring Boot生产环境配置 #

Docker启动Spring Boot应用时默认会启用prod环境，而Spring Boot在生产环境下默认会隐藏错误详情信息。需要在application-prod.properties或application-prod.yml中添加以下配置，确保错误信息被返回：

# 允许在响应中包含错误消息
server.error.include-message=always
# 如果需要绑定错误信息也可开启
server.error.include-binding-errors=always

3. 验证Docker镜像与启动配置 #

• 确认构建Docker镜像时，是否将生产环境的配置文件（如application-prod.properties）正确打包进镜像，避免配置缺失。
• 检查容器启动命令是否指定了正确的环境变量，例如SPRING_PROFILES_ACTIVE=prod，确保生产环境配置生效。
• 查看容器内的应用日志，排查是否存在@ControllerAdvice Bean加载失败的警告，或异常未被正确捕获的日志信息。

4. 确认异常处理方法是否被触发 #

在异常处理方法中添加日志打印，验证Docker环境下该方法是否被正常调用：

import org.slf4j.LoggerFactory

private val logger = LoggerFactory.getLogger(javaClass)

@ExceptionHandler(DepartmentNotFoundException::class)
fun departmentNotFound(exception: DepartmentNotFoundException): ResponseEntity<String> {
    logger.debug("触发DepartmentNotFoundException处理逻辑，异常信息：{}", exception.message)
    return ResponseEntity.status(HttpStatus.NOT_FOUND)
        .body("Department with this id not found!")
}

启动容器后查看日志，确认日志是否输出，以此判断方法是否生效。

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