마시멜로

try {
    restTemplate.getForObject(url, String.class);
} catch (HttpServerErrorException e) {
    log.error("타사 API 서버 오류: {}, 응답 바디: {}", e.getStatusCode(), e.getResponseBodyAsString());
    throw new ExternalApiException("타사 시스템 오류입니다. 잠시 후 다시 시도해주세요.");
}

catch (ResourceAccessException e) {
    log.warn("타사 API 연결 불가: {}", e.getMessage());
    throw new ExternalApiException("현재 외부 시스템과 통신할 수 없습니다.");
}

try {
    var response = restTemplate.exchange(...);
    return objectMapper.readValue(response.getBody(), ExternalDto.class);
} catch (JsonProcessingException e) {
    log.error("타사 JSON 파싱 오류: {}", e.getMessage());
    throw new ExternalApiException("타사 응답 포맷이 올바르지 않습니다.");
}

java.net.UnknownHostException: api.unknown-external-service.com

RestTemplate restTemplate = new RestTemplate();
String url = "https://external.api.com/data";

try {
    ResponseEntity<String> response = restTemplate.getForEntity(url, String.class);
} catch (HttpClientErrorException e) {
    System.out.println("타사 API 오류 발생: " + e.getStatusCode());
    System.out.println("응답 본문: " + e.getResponseBodyAsString());
}

public String callExternalApi(String token) {
    try {
        HttpHeaders headers = new HttpHeaders();
        headers.set("Authorization", "Bearer " + token);
        HttpEntity<?> request = new HttpEntity<>(headers);

        return restTemplate.exchange("https://api.example.com/data", HttpMethod.GET, request, String.class).getBody();

    } catch (HttpClientErrorException e) {
        log.error("[타사 API 오류] 상태코드: {}, 응답: {}", e.getStatusCode(), e.getResponseBodyAsString());

        if (e.getStatusCode() == HttpStatus.UNAUTHORIZED) {
            throw new ExternalApiAuthException("타사 인증 오류: 토큰 만료 또는 누락");
        } else {
            throw new ExternalApiException("타사 API 오류", e);
        }
    }
}

POST /api/users
Content-Type: application/xml

<user><name>John</name></user>

Content type 'application/xml' not supported

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(HttpMediaTypeNotSupportedException.class)
    public ResponseEntity<ErrorResponse> handleUnsupportedMediaType(HttpMediaTypeNotSupportedException ex) {
        String msg = "지원하지 않는 Content-Type입니다. application/json으로 요청해주세요.";
        return ResponseEntity.status(HttpStatus.UNSUPPORTED_MEDIA_TYPE)
                .body(new ErrorResponse("UNSUPPORTED_MEDIA_TYPE", List.of(msg)));
    }
}

POST /users
Content-Type: application/json

{
  "name": "",             // 이름이 공백
  "age": -5               // 나이가 음수
}

public record UserRequest(
    @NotBlank(message = "이름은 필수입니다.")
    String name,

    @Min(value = 0, message = "나이는 0 이상이어야 합니다.")
    int age
) {}

org.springframework.web.bind.MethodArgumentNotValidException:
Validation failed for argument [0] in public ResponseEntity ...

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ErrorResponse> handleValidationErrors(MethodArgumentNotValidException ex) {
        List<String> errorMessages = ex.getBindingResult()
            .getFieldErrors()
            .stream()
            .map(error -> error.getField() + ": " + error.getDefaultMessage())
            .toList();

        return ResponseEntity.badRequest().body(new ErrorResponse("VALIDATION_FAILED", errorMessages));
    }
}

public record ErrorResponse(String code, List<String> messages) {}

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "code": "VALIDATION_FAILED",
  "messages": [
    "name: 이름은 필수입니다.",
    "age: 나이는 0 이상이어야 합니다."
  ]
}

POST /users
Content-Type: application/json

{
  "name": "Kim",
  "age": "스무살"     ← 정수여야 하는데 문자열!
}

Resolved [org.springframework.http.converter.HttpMessageNotReadableException: 
JSON parse error: Cannot deserialize value of type `int` from String "스무살"]

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<ErrorResponse> handleBadRequest(HttpMessageNotReadableException ex) {
        String message = "요청 본문 형식이 잘못되었습니다. 숫자 필드에 문자열이 들어갔는지 확인하세요.";
        return ResponseEntity
                .badRequest()
                .body(new ErrorResponse("INVALID_JSON", message));
    }
}

public record ErrorResponse(String code, String message) {}

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "code": "INVALID_JSON",
  "message": "요청 본문 형식이 잘못되었습니다. 숫자 필드에 문자열이 들어갔는지 확인하세요."
}

npx nuxi generate

NUXT_PUBLIC_API_BASE=https://api.example.com

export default defineNuxtConfig({
  ssr: false, // SPA 모드
  nitro: {
    preset: "static"
  },
  runtimeConfig: {
    public: {
      apiBase: process.env.NUXT_PUBLIC_API_BASE
    }
  },
  app: {
    baseURL: "/", // 일반적 SPA라면 루트
    buildAssetsDir: "/_nuxt/",
  },
})

export function useApiFetch<T>(url: string, options = {}) {
  const config = useRuntimeConfig();
  return $fetch<T>(url, {
    baseURL: config.public.apiBase,
    ...options,
  });
}

// 사용 예시
await useApiFetch("/api/v1/login", {
  method: "POST",
  body: { username, password },
});

location / {
  root /var/www/html;
  index index.html;
  try_files $uri $uri/ /index.html;
}

location /_nuxt/ {
  root /var/www/html;
  access_log off;
}