SpringBoot容器化后500错误响应无message问题排查求助

问题现象 #

• 本地通过mvn spring-boot:run运行时，500错误响应包含message和trace字段：

  {
      "timestamp": 1704496938120,
      "status": 500,
      "error": "Internal Server Error",
      "trace": "(Long message)",
      "message": "Authentication failed!",
      "path": "/api/conferences/1/check_roles"
  }
  

• Docker容器化部署后，500错误响应丢失message字段：

  {
      "timestamp": 1704495987474,
      "status": 500,
      "error": "Internal Server Error",
      "path": "/api/conferences/1/check_roles"
  }
  

• 已排查：前端Nginx容器配置无问题，自定义ExceptionHandler未解决该问题。

原因分析 #

Spring Boot默认根据运行环境控制错误响应的字段展示逻辑：

• 本地开发环境（默认dev）会主动暴露message、trace等详细错误信息，方便调试；
• Docker容器部署时，Spring Boot默认启用prod生产环境，出于安全考虑，默认隐藏message、trace等敏感字段，仅返回基础错误框架信息。

解决方案 #

1. 通过配置文件调整错误信息展示 #

在容器使用的生产环境配置文件（如application-prod.yml）中添加以下配置，强制开启message字段的返回：

server:
  error:
    include-message: always  # 可选值：never/always/on-param，设置always强制返回message
    include-trace: never     # 根据需求选择是否返回trace，生产环境建议关闭

2. 修正自定义全局异常处理器 #

如果之前的自定义ExceptionHandler未生效，可能是实现细节有误，以下是正确的全局异常处理示例：

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleGeneralException(Exception ex, HttpServletRequest request) {
        ErrorResponse response = new ErrorResponse();
        response.setTimestamp(LocalDateTime.now());
        response.setStatus(HttpStatus.INTERNAL_SERVER_ERROR.value());
        response.setError("Internal Server Error");
        response.setMessage(ex.getMessage()); // 确保将异常message传入响应体
        response.setPath(request.getRequestURI());

        return new ResponseEntity<>(response, HttpStatus.INTERNAL_SERVER_ERROR);
    }

    // 自定义错误响应实体类
    static class ErrorResponse {
        private LocalDateTime timestamp;
        private int status;
        private String error;
        private String message;
        private String path;

        // 构造方法、Getter/Setter省略
    }
}

注意：确保@RestControllerAdvice注解生效，且异常被正确捕获（避免被Spring Boot默认的错误处理器拦截）。

3. 强制指定容器运行环境 #

如果需要在容器中临时使用开发环境的错误返回逻辑，可以在启动容器时指定环境变量：

docker run -e SPRING_PROFILES_ACTIVE=dev your-spring-boot-image

此方法仅建议用于调试，生产环境不推荐。

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