본문 바로가기

전체 글76

파일 업로드가 튕겨요! MaxUploadSizeExceededException 원인과 1분 해결법 (공항 수하물 비유) 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 게시판에 '첨부파일' 기능이나 마이페이지의 '프로필 이미지 업로드' 기능을 며칠 밤을 새워 완성했습니다. 구글에서 다운받은 귀여운 100KB짜리 아이콘으로 테스트했을 때는 아주 완벽하게 서버에 저장이 되었습니다. "좋아, 완벽해! 이제 실전 테스트다!"하고 스마트폰으로 찍은 5MB짜리 고화질 사진을 올리는 순간... 브라우저는 뻗어버리고 서버 콘솔 창에는 붉은 에러가 길게 쏟아집니다. org.springframework.web.multipart.MaxUploadSizeExceededException: Maximum upload size exceeded "아니, 코드는 똑같은데 왜 작은 파일은 되고 큰 파일은 안 되는 거지?"초보 백엔드 개발자들이 .. 2026. 7. 23.
415 에러? HttpMediaTypeNotSupportedException 원인과 1분 해결법 (DVD와 비디오테이프 비유) 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 이전 포스팅에서 다루었던 '405 에러(메서드 불일치)'를 무사히 해결하고, 드디어 올바른 POST 방식으로 데이터를 보냈습니다. 그런데 이번에는 데이터를 받자마자 서버가 또 다른 붉은 에러를 뱉어냅니다. org.springframework.web.HttpMediaTypeNotSupportedException: Content type 'text/plain;charset=UTF-8' not supported (혹은 415 Unsupported Media Type 상태 코드) "방식(POST)도 맞췄고, 데이터도 잘 적어서 보냈는데 미지원 미디어 타입이라니?" 초보 개발자들이 프론트엔드와 백엔드를 처음 연결할 때 가장 많이 마주치는 통곡의 벽입니다. .. 2026. 7. 22.
포스트맨이 멈추지 않아요! JPA 순환 참조(무한 루프) 에러 원인과 DTO 해결법 (거울 방 비유) 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 스프링 부트(Spring Boot)와 JPA를 이용해 게시판을 만들고, "게시글(Post)을 조회하면 그 안에 달린 댓글(Comment)들도 함께 보여줘야지!"라며 야심 차게 API를 완성했습니다. 그리고 포스트맨(Postman)에서 Send 버튼을 누르는 순간! 갑자기 포스트맨 화면의 JSON 데이터가 끝도 없이 주르륵 내려가더니, 서버 콘솔 창에는 아래와 같은 무시무시한 에러가 뿜어지며 서버가 뻗어버립니다. java.lang.StackOverflowError(또는 HttpMessageNotWritableException: Infinite recursion (StackOverflowError)) "데이터가 왜 끝없이 나오는 거지? 내가 해킹이라도.. 2026. 7. 21.
DB가 응답하지 않아요! Communications link failure 원인과 3분 해결법 (식당 전화 비유) 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 스프링 부트(Spring Boot)로 열심히 코드를 짜고 드디어 서버를 실행했는데, 콘솔 창에 빨간색 글씨가 폭포수처럼 쏟아지며 서버가 켜지지 않은 적 있으신가요? 가장 윗줄로 스크롤을 올려보면 아래와 같은 무시무시한 에러 메시지가 적혀 있습니다. com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure(또는 java.net.ConnectException: Connection refused: connect) "통신 링크 실패라고? 내 인터넷이 끊겼나? 코드를 잘못 짰나?"초보 백엔드 개발자들을 패닉에 빠뜨리는 가장 흔한 DB 연결 에러입니다. 하지만 걱정하지 .. 2026. 7. 20.
405 에러? HttpRequestMethodNotSupportedException 원인과 1분 해결법 (당기시오 문을 미는 중!) 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 포스트맨(Postman)이나 프론트엔드에서 백엔드 서버로 정성스럽게 API 요청을 보냈는데, 데이터를 받아보기는커녕 아래와 같은 길고 무시무시한 에러 메시지와 함께 405 Method Not Allowed 상태 코드가 떨어질 때가 있습니다. org.springframework.web.HttpRequestMethodNotSupportedException: Request method 'GET' not supported(혹은 'POST' not supported)"주소(URL)에 오타도 없고, 서버도 정상적으로 켜져 있는데 도대체 뭐가 문제라는 거지?" 초보 개발자들이 가장 많이 겪으면서도 은근히 원인을 찾지 못해 헤매는 이 에러! 오늘은 이 'HTTP.. 2026. 7. 19.
이미 사용 중인 포트? Port 8080 was already in use 에러 원인과 초간단 해결법 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 새로운 기능을 완성하고 설레는 마음으로 스프링 부트(Spring Boot) 서버의 실행(Run) 버튼을 마우스로 딱 클릭했습니다. 빌드가 완료되고 로그가 촤르륵 올라가며 서버가 켜지는가 싶더니, 갑자기 시뻘건 에러 로그를 뿜어내며 1초 만에 서버가 툭 꺼져버립니다. 상단에 적힌 강렬한 경고 메시지.Web server failed to start. Port 8080 was already in use. 분명히 아까까지만 해도 잘 돌아갔는데 왜 갑자기 포트가 이미 사용 중이라는 걸까요? 오늘은 백엔드 개발자라면 누구나 일주일에 한 번씩은 마주치는 '포트 충돌(Port Already in Use) 에러'의 원인을 아주 명쾌한 비유로 알아보고, 윈도우와 맥.. 2026. 7. 18.

티스토리툴바