Back to the Basics Back to the Basics

Jackson JSON 트러블슈팅을 위한 각 오류별 구체적인 예제와 JUnit 기반 테스트 코드를 정리한 Java 코드 문서를 생성했습니다. 이 문서에는 다음과 같은 내용을 포함하고 있습니다:UnrecognizedPropertyException (정의되지 않은 필드)InvalidFormatException (타입 불일치)JavaTimeModule 미등록으로 인한 날짜 오류Enum 역직렬화 실패순환 참조 문제와 @JsonManagedReference, @JsonBackReference 사용 예제// Java JSON 처리 실전 – Jackson 트러블슈팅 확장 예제 모음// 1. UnrecognizedPropertyException 예제public class User { private String n..

Jackson과 Spring Boot에서 JSON 처리 중 자주 발생하는 에러 메시지와 그 원인을 분석합니다. 실전 환경에서 발생하는 문제 해결 전략을 중심으로 직렬화/역직렬화 오류에 대응합니다.1. UnrecognizedPropertyException: 알 수 없는 필드 오류증상com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException:Unrecognized field "unknown_field"원인JSON 요청 본문에 Java 클래스에 정의되지 않은 필드가 포함된 경우 발생해결 방법DTO 클래스에 해당 필드를 추가하거나다음 설정을 통해 무시할 수 있음// 클래스 단위 설정@JsonIgnoreProperties(ignoreUnknown = tru..

Spring Boot + Jackson 환경에서 JSON 처리 시 자주 발생하는 오류와 그 해결법을 정리합니다. JsonParseException, UnrecognizedPropertyException, 날짜 포맷, Enum 처리 오류 등 실전 사례 중심의 트러블슈팅 가이드입니다.Jackson은 Java JSON 처리에 매우 강력한 도구이지만, 실무에서는 예상치 못한 오류가 종종 발생합니다. 특히 외부 API 요청, 클라이언트-서버 간 형식 불일치, DTO 설계 미흡 등이 원인이 되는 경우가 많습니다.이 글에서는 Spring Boot 환경에서 발생할 수 있는 대표적인 JSON 처리 오류 7가지와 그 해결 전략을 명확히 정리해보겠습니다.1. UnrecognizedPropertyException – 알 수 ..

Jackson은 JSON뿐 아니라 YAML, XML 등 다양한 포맷을 처리할 수 있는 모듈을 제공합니다. Spring Boot 환경에서 포맷 변환을 구현하는 방법과 실무 활용 전략을 예제로 설명합니다.1. 왜 JSON 외의 포맷이 필요한가?REST API 시대에도 여전히 다음과 같은 이유로 다양한 포맷 변환 수요가 존재합니다:YAML: 설정 파일, DevOps 구성, Kubernetes manifest 등에서 주로 사용XML: 금융, 보험, 공공기관 등 레거시 시스템과의 연동에서 사용CSV: 데이터 이관, 리포트, 분석용 다운로드 등에서 필요JSON ↔ YAML ↔ XML 간 변환이 필요한 상황이 실제 현장에서 반복적으로 발생Jackson은 이 모든 포맷을 하나의 ObjectMapper 구조를 확장해서 ..

Jackson에서 따옴표 없는 필드, 단일 따옴표 등 비표준 JSON 형식을 처리하는 방법을 다룹니다. JsonParser.Feature.ALLOW_UNQUOTED_FIELD_NAMES 활용법과 실무 적용 시 주의사항을 정리합니다.1. 왜 따옴표 없는 JSON이 문제가 되는가?표준 JSON에서는 모든 키와 문자열 값에 반드시 **쌍따옴표(")**가 있어야 합니다.RFC 8259 – JSON 표준 예시:{ "name": "홍길동", "age": 30}그러나 실무에서는 다음과 같은 비표준 JSON을 종종 마주합니다:{ name: '홍길동', age: 30}키에 쌍따옴표 없음문자열 값에 단일 따옴표 사용이런 JSON은 Jackson의 기본 설정으로는 파싱되지 않고 JsonParseException이 발..

Jackson에서 커스텀 Serializer 및 Deserializer를 구현해 특수 포맷, 민감 정보, 복합 필드에 대한 JSON 직렬화/역직렬화를 제어하는 방법을 실무 예제 중심으로 설명합니다.Spring Boot에서 기본적인 JSON 직렬화/역직렬화는 ObjectMapper가 자동으로 처리해줍니다. 그러나 아래와 같은 상황에서는 커스텀 Serializer 또는 Deserializer가 필요해집니다.특정 필드를 Base64 인코딩 또는 마스킹 처리하고 싶을 때날짜 포맷이 비표준이거나 복합적인 형태일 때중첩된 객체를 평탄화하거나 축약해서 표현하고 싶을 때클라이언트에 따라 JSON 포맷을 맞춤화하고 싶을 때이번 글에서는 Jackson에서 커스텀 직렬화/역직렬화 클래스를 구현하고 적용하는 방법을 구체적인 ..

Spring Boot + Jackson 환경에서 JSON 응답 필드를 제어하는 방법을 정리합니다. @JsonInclude, @JsonView, @JsonFilter를 활용한 null 제거, 조건부 노출, 민감 정보 제외 전략을 실전 예제 중심으로 소개합니다.REST API를 설계하다 보면 다음과 같은 고민이 자주 발생합니다:값이 null인 필드는 응답에서 빼고 싶다일부 필드는 관리자만 볼 수 있어야 한다한 객체를 다양한 응답 구조로 재사용하고 싶다Jackson은 이런 문제를 해결하기 위한 어노테이션과 설정 옵션을 제공합니다. 이번 글에서는 API 응답을 더 가볍고 안전하게 만들 수 있는 필드 제어 전략을 정리합니다.1. @JsonInclude – null 또는 빈 값 제외가장 기본이 되는 필드 제어 전략..

Spring MVC에서 JSON 요청을 수신하고 JSON 응답을 반환하는 내부 흐름을 @RequestBody, @ResponseBody, HttpMessageConverter, Jackson 중심으로 구조적으로 정리합니다.Spring Boot 기반 REST API 개발을 하다 보면 다음과 같은 작업이 아주 자연스럽게 이루어집니다:@PostMapping("/user")public UserResponse register(@RequestBody UserRequest request) { return userService.create(request);}이 한 줄에는 다양한 내부 처리 흐름이 숨어 있습니다. 이 글에서는 Spring MVC가 JSON 데이터를 Jackson을 통해 어떻게 처리하는지 구조적으로 ..