JWT 인증 실패와 권한 오류 처리 전략, 401과 403을 올바르게 구분하는 방법

JWT 인증 실패와 권한 오류가 발생하는 원인부터 Spring Security 환경에서의 예외 처리 전략까지 자세히 알아보겠습니다. 401과 403의 차이, JWT 인증 실패 처리 방법, 권한 설정 시 주의사항, 자주 발생하는 오류 해결 방법을 함께 정리해 드리겠습니다.JWT를 적용하는 과정에서 가장 많이 만나는 문제가 jwt 인증 실패, jwt 오류, jwt 권한 설정, jwt 자격 증명에 실패하였습니다와 같은 메시지입니다.특히 Spring Security를 사용하는 프로젝트에서는 로그인은 정상적으로 완료되는데 API 호출 시 401 또는 403 오류가 발생하는 경우가 많습니다. 이때는 단순히 토큰 자체만 확인하기보다 인증(Authentication)과 권한(Authorization)을 구분하여 접근하..

• format_list_bulleted 실무개발
• · 2026. 7. 28.
• textsms

Spring @ModelAttribute 사용법, POST 요청에서도 자동 바인딩될까?

Spring MVC에서 @ModelAttribute는 @PostMapping에서도 자동으로 동작합니다. Form 데이터와 JSON 요청의 차이, @RequestBody와의 사용 기준, 자동 바인딩 원리까지 예제와 함께 자세히 정리했습니다.Spring을 처음 배우다 보면 @ModelAttribute는 GET 요청에서만 사용하는 것처럼 느껴질 수 있습니다. 특히 @PostMapping에서 DTO가 자동으로 채워지는지 궁금해하는 경우가 많습니다.결론부터 말하면 @ModelAttribute는 GET뿐만 아니라 POST 요청에서도 자동으로 데이터를 바인딩합니다. 다만 요청 방식과 Content-Type에 따라 사용할 어노테이션이 달라집니다. 이 차이만 이해하면 @ModelAttribute와 @RequestBody..

• format_list_bulleted 실무개발
• · 2026. 7. 24.
• textsms

VS Code + Spring Boot + Gradle에서 외부 JAR 파일 적용하는 방법

VS Code에서 Spring Boot와 Gradle 프로젝트에 외부 JAR 파일을 추가하는 방법을 정리했습니다. libs 폴더에 JAR 파일을 추가한 후 Gradle 빌드, Java Language Server 캐시 초기화, VS Code 인식 오류 해결 방법까지 자세히 설명합니다.Spring Boot 프로젝트를 개발하다 보면 Maven Central이나 Gradle Repository에 등록되어 있지 않은 라이브러리를 직접 받아 프로젝트에 추가해야 하는 경우가 있습니다.대표적으로 회사 내부 라이브러리나 외부 업체에서 제공하는 SDK, 또는 직접 빌드한 라이브러리를 사용할 때가 많습니다.IntelliJ에서는 대부분 자동으로 인식되는 경우가 많지만, VS Code에서는 libs 폴더에 JAR 파일만 복사..

• format_list_bulleted 실무개발
• · 2026. 7. 24.
• textsms

해시(Hash), 암호화(Encryption), 전자서명(Digital Signature) 한 번에 이해하기

많은 개발자가 처음에는 해시(Hash), 암호화(Encryption), 전자서명(Digital Signature) 을 비슷한 개념으로 생각합니다.하지만 목적과 동작 방식은 완전히 다릅니다.핵심만 먼저 정리하면 다음과 같습니다.암호화: 데이터를 숨기기 위한 기술 (복호화 가능)해시: 데이터가 변경되었는지 확인하기 위한 기술 (복호화 불가)전자서명: 해시값에 개인키로 서명하여 작성자와 무결성을 증명하는 기술1. 암호화(Encryption)암호화는 데이터를 숨기는 것이 목적입니다.예를 들어 주문 데이터가 있다고 가정해보겠습니다.종목 : 삼성전자가격 : 100,000수량 : 10암호화하면A89D91A7...처럼 알아볼 수 없는 값으로 변합니다.복호화 키를 가지고 있으면 다시 원래 데이터로 복원할 수 있습니다.원..

• format_list_bulleted 실무개발
• · 2026. 7. 23.
• textsms

전자서명이란? 개발자가 반드시 알아야 할 개념과 구현 방식 정리

전자서명의 개념부터 디지털 서명과의 차이, 공개키 기반 구조(PKI), 서명 생성 및 검증 과정, 개발 시 주의사항까지 개발자가 반드시 알아야 할 전자서명 핵심 내용을 실무 관점에서 정리했습니다.전자계약, 본인인증, API 인증, 금융 서비스, 공공 시스템을 개발하다 보면 전자서명(Electronic Signature) 이라는 용어를 자주 접하게 됩니다.하지만 많은 개발자가 전자서명과 디지털 서명을 같은 의미로 이해하거나, 단순히 암호화 기술 정도로 생각하는 경우가 많습니다.실제로는 전자서명은 법적인 개념이고, 디지털 서명은 이를 구현하는 대표적인 기술입니다. 이 차이를 이해하면 인증 시스템, JWT, SSL/TLS, 전자계약, 공인 인증 등 다양한 보안 기술을 훨씬 쉽게 이해할 수 있습니다.이번 글에서..

• format_list_bulleted 실무개발
• · 2026. 7. 23.
• textsms

Spring Boot REST API 예외 처리 ExceptionHandler 완벽 정리

Spring Boot REST API에서 예외 처리를 표준화하는 방법을 정리해 드립니다. @ExceptionHandler와 @RestControllerAdvice 활용법부터 Validation 예외, 커스텀 예외, 공통 응답 구조까지 실무 중심으로 자세히 알아보시기 바랍니다.REST API를 개발하다 보면 다양한 예외 상황을 반드시 고려해야 합니다. 잘 설계된 API는 단순히 정상 응답만 제공하는 것이 아니라, 오류가 발생했을 때도 일관된 형식으로 오류 정보를 반환합니다.Spring Boot에서는 @ExceptionHandler, @RestControllerAdvice, @ResponseStatus 등을 활용하여 예외 처리를 표준화할 수 있습니다. 이번 글에서는 실무에서 많이 사용하는 Spring Boo..

• format_list_bulleted 실무개발
• · 2026. 7. 19.
• textsms