본문 바로가기

💻 트러블슈팅 (에러 해결)25

화면이 안 떠요! Error resolving template 원인과 1분 해결법 (유령 접시 비유) 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 스프링 부트(Spring Boot)로 웹 페이지를 만들거나, API를 개발하고 나서 브라우저로 접속을 해봅니다. "좋아, 이제 내가 만든 예쁜 화면(또는 데이터)이 뜨겠지?" 하지만 기대와 달리 브라우저에는 'Whitelabel Error Page'와 함께 500 에러가 뜨고, 스프링 부트 콘솔 창에는 아래와 같은 길고 짜증 나는 에러가 출력됩니다. org.thymeleaf.exceptions.TemplateInputException: Error resolving template [index], template might not exist or might not be accessible "분명히 코드에 빨간 줄도 없고 로직도 완벽한데, 템플릿(Te.. 2026. 7. 26.
DB가 데이터를 뱉어내요! DataIntegrityViolationException 원인과 해결법 (영화관 지정좌석 비유) 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 회원가입 기능이나 게시글 작성 기능을 만들고 나서 "이제 DB에 데이터가 잘 들어가겠지?"라며 테스트를 돌려봅니다. 그런데 스프링 부트(Spring Boot) 콘솔 창에 시뻘건 글씨와 함께 다음과 같은 무시무시한 에러가 터집니다. org.springframework.dao.DataIntegrityViolationException: could not execute statement; SQL [n/a]; constraint [...] "데이터 무결성 위반? 내가 무슨 법이라도 어긴 건가?"초보 백엔드 개발자들이 JPA나 Mybatis를 이용해 데이터베이스(DB)에 값을 넣을 때(INSERT/UPDATE) 정말 자주 만나는 단골 에러입니다. 오늘은 이름.. 2026. 7. 25.
400 에러? Required request parameter is not present 원인과 1분 해결법 (관공서 필수 서류 비유) 안녕하세요, 여러분의 든든한 IT 길잡이 데브프리입니다. 프론트엔드 개발자나 포스트맨(Postman)으로 API 테스트를 진행하다 보면, 서버가 터진 것도 아니고 주소가 틀린 것도 아닌데 '400 Bad Request'라는 찝찝한 상태 코드가 떨어질 때가 있습니다. 스프링 부트(Spring Boot)의 콘솔 창을 열어보면 아래와 같은 붉은 에러 메시지가 찍혀 있죠. org.springframework.web.bind.MissingServletRequestParameterException: Required request parameter 'username' for method parameter type String is not present "분명히 데이터 잘 보냈는데 왜 파라미터가 없다는 거지?"초보 개.. 2026. 7. 24.
파일 업로드가 튕겨요! 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.