1
2
3

GET /api/users/99999 -> 302 Found, Location: /error
(또는 컨트롤러에서 RuntimeException 발생 시 기본 /error 로 리다이렉트되어
  JSON 에러 바디 대신 오류 페이지 응답이 내려옴)

1
2
3
4

# 핸들러가 있는 경로에 대해 예외를 유발 -> 리다이렉트 여부 확인
curl -si http://localhost:8080/api/users/1 | head -20
# 핸들러가 없는 경로 -> 404가 JSON이 아니라 잘못된 응답으로 오는지 확인
curl -si http://localhost:8080/no-such-endpoint | head -20

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(value = { Exception.class })
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public ApiErrorResponse unknownException(Exception ex, WebRequest req) {
        // 여기서 예외를 UUID와 함께 NoSQL에 로그하고,
        // 클라이언트에는 로그 항목의 UUID를 담은 JSON을 반환한다.
        return new ApiErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR.value(), ex.getMessage(), Instant.now());
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

@ControllerAdvice
public class MyExceptionHandler extends ResponseEntityExceptionHandler {

    @ExceptionHandler({ HttpMessageNotReadableException.class,
                        MethodArgumentNotValidException.class,
                        HttpRequestMethodNotSupportedException.class })
    public ResponseEntity<Object> badRequest(HttpServletRequest req, Exception exception) {
        return ResponseEntity.badRequest().body(new ApiError(400, exception.getMessage(), Instant.now()));
    }

    @Override
    protected ResponseEntity<Object> handleNoHandlerFoundException(
            NoHandlerFoundException ex, HttpHeaders headers,
            HttpStatus status, WebRequest request) {
        Map<String, String> body = Map.of(
            "code", "1000",
            "message", "No handler found for your request.",
            "timestamp", Instant.now().toString());
        return new ResponseEntity<>(body, HttpStatus.NOT_FOUND);
    }
}

1
2
3
4

# 핸들러를 찾지 못하면 포워드 대신 NoHandlerFoundException을 던지게 함
spring.mvc.throw-exception-if-no-handler-found=true
# 정적 리소스 자동 매핑을 끔 (/** 로 먼저 가로채는 것을 차단)
spring.resources.add-mappings=false

1
2
3
4
5
6
7
8
9

@ComponentScan
@EnableAutoConfiguration
public class MyApplication extends SpringBootServletInitializer {
    public static void main(String[] args) {
        ApplicationContext ctx = SpringApplication.run(MyApplication.class, args);
        DispatcherServlet ds = (DispatcherServlet) ctx.getBean("dispatcherServlet");
        ds.setThrowExceptionIfNoHandlerFound(true);
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

@Controller
public class CustomErrorController extends BasicErrorController {

    public CustomErrorController(ServerProperties serverProperties) {
        super(new DefaultErrorAttributes(), serverProperties.getError());
    }

    @Override
    public ResponseEntity<Map<String, Object>> error(HttpServletRequest request) {
        HttpStatus status = getStatus(request);
        if (status == HttpStatus.INTERNAL_SERVER_ERROR) {
            return ResponseEntity.status(status).body(Map.of("message", "SERVER_ERROR"));
        } else if (status == HttpStatus.BAD_REQUEST) {
            return ResponseEntity.status(status).body(Map.of("message", "BAD_REQUEST"));
        }
        return super.error(request);
    }
}

1
2
3
4
5
6
7
8

# 1) 핸들러가 있는 URL에서 예외 유발 -> 5xx + JSON 바디 확인
curl -si http://localhost:8080/api/users/1 | head -20

# 2) 존재하지 않는 URL -> 404 Not Found + JSON 바디 확인 (리다이렉트가 아님)
curl -si http://localhost:8080/no-such-endpoint | head -20

# 3) 리다이렉트 여부(Location: /error)가 사라졌는지 확인
curl -si -o /dev/null -w "HTTP %{http_code} redirect:%{redirect_url}\n" http://localhost:8080/no-such-endpoint

1
2
3

mockMvc.perform(get("/no-such-endpoint"))
       .andExpect(status().isNotFound())
       .andExpect(jsonPath("$.message").value("No handler found for your request."));