PROJECT

Team Personal

STUDY

Language Framework

PHOTO

MoodHolic

👨🏻‍💻 내가 기여한 부분

📚 사용 기술

🧩 System Architecture

내가 기여한 부분

•

OAuth2를 이용하여 Google, Naver, Kakao, GitHub 소셜 로그인 기능을 구현

•

OpenAI API를 활용하여 사용자가 작성한 일기를 프롬프트를 작성하도록하여 일기 분석을해서 점수로 도출 시키는 기능 구현

•

JWT를 활용한 인증 절차를 구축하고, Redis에 토큰을 저장하여 보안성을 강화

•

GitHub을 통한 형상 관리를 수행하며, Git Flow 전략, 커밋 및 PR 컨벤션, 코드 컨벤션을 도입하여 코드의 일관성을 유지하고 오류를 방지

•

사용자들이 어느 플랫폼에서 접속할 수 있게 하기 위해 React Native와 Expo를 활용하여 WebApp을 개발

•

수행할 작업을 계획하고 목표 설정하기 위해 Sprint 도입하여 1주 단위로 Sprint 작업을 진행

헤더

로그인 후 다이어리

로그인 페이지

로그인 후 마이페이지

마이페이지 ‘내 다이어리’ 통계 화면

사용 기술

•

DataBase

◦

MariaDB / Redis

•

BackEnd

◦

Java / Spring Boot / Spring Data JPA / Spring Security / JWT / Google Storage

•

API

◦

Kakao Login / Google Login / OpenAI / Swagger / OpenWeatherMap

•

Software Architecture Pattern

◦

Monolithic Architecture

•

FrontEnd

◦

HTML / CSS / JavaScript / Vue.js / VueX / React Native

•

DevOps

◦

Docker / Jenkins / Kubernetes / AWS EC2

•

Collaboration

◦

GitHub / Slack / Notion / Figma / Miro

System Architecture

MoodHolic System Architecture

트러블 슈팅 1

문제 배경

Spring Boot 기반의 웹 애플리케이션에서 OpenAPI 요청 중, 클라이언트가 특수 문자가 포함된 URL을 요청했을 때 java.lang.IllegalArgumentException: Invalid character found in the request target 오류가 발생했습니다.

이는 Tomcat 서버의 기본 설정에서 특정 특수 문자가 허용되지 않아 발생한 문제였습니다. 처음에는 application.yml에서 UTF-8 인코딩을 강제로 적용하려 했으나, 이 방법은 문제 해결에 실패했습니다. 특수 문자가 포함된 URL은 Tomcat 서버의 기본 설정과 충돌하였기 때문에 문제가 발생했습니다.

해결 방법

문제 해결을 위해, Tomcat 서버의 설정을 커스터마이징하여 특정 특수 문자를 허용하도록 조정했습니다. TomcatServletWebServerFactory 클래스를 오버라이드하고, relaxedQueryChars 옵션을 추가하여 <, >, [, ], ^, `, {, |, } 등의 특수 문자를 허용하도록 설정했습니다.

개선 결과

Tomcat 서버에서 기본적으로 허용하지 않는 문자들을 쿼리 파라미터로 사용할 수 있게 해주었습니다.

이 설정 이후, 특수 문자가 포함된 URL 요청이 정상적으로 처리될 수 있었고, 더 이상 동일한 오류가 발생하지 않았습니다. 특정 URL 요청의 처리를 방해하던 문제를 해결했으며, 요청을 안정적으로 처리할 수 있는 환경을 구축하게 되었습니다.

해당 경험을 통해 알게 된 점

서버 설정의 중요성과 맞춤형 설정이 애플리케이션의 안정성에 큰 영향을 미친다는 것을 배웠습니다. 또한, 단순한 설정 변경으로 복잡한 문제를 해결할 수 있다는 사실을 깨달았습니다.

TISTORYSpring Boot 웹 애플리케이션에서 특수 문자 오류 해결하기: java.lang.IllegalArgumentException: Invalid character found in the request target 문제 접근법

application.yml에서 강제로 인코딩

Config 패키지에 TomcatWebCustomCofig Class 추가하여 허용 특수문자 설정

트러블 슈팅 2

문제 배경

Spring Boot 기반의 웹 애플리케이션에서 API 응답에 한글 문자가 올바르게 표시되지 않고, 물음표(???)로 대체되는 문제가 발생했습니다. 이는 Spring 프레임워크의 기본 인코딩 설정이 ISO-8859-1로 되어 있어, 한글과 같은 다국어 문자를 제대로 처리하지 못하는 것에서 비롯된 문제였습니다.

해결 방법

문제를 해결하기 위해 Spring의 WebMvcConfigurer를 오버라이드하여 StringHttpMessageConverter를 UTF-8 인코딩으로 설정했습니다. 이것을 통해 응답 메시지가 한글로 제대로 인코딩되어 클라이언트에 전달될 수 있게 했습니다. UTF-8 인코딩이 우선 적용되어 한글 인코딩 문제가 발생하지 않도록 하기 위해 StringHttpMessageConverter를 컨버터 목록의 가장 앞에 두어 다른 컨버터보다 먼저 실행되도록 설정했습니다.

개선 결과

이 설정을 통해 한글 인코딩 문제가 해결되었고, API 응답에서 한글 문자가 온전히 표시되었습니다. 이전에는 클라이언트 측에서 물음표(???)로 보였던 한글 메시지들이 정확히 전달되었으며, 또한, 이러한 문제 해결 과정에서 얻은 경험을 통해 다른 언어 환경에서도 문자 인코딩 문제를 보다 신속하고 효과적으로 대응할 수 있는 역량을 갖추게 되었습니다.

해당 경험을 통해 알게 된 점

웹 애플리케이션에서 문자 인코딩 설정의 중요성을 깊이 이해하게 되었습니다. 특히 다국어 지원이 필요한 환경에서는 인코딩 설정을 세밀하게 관리해야만 예기치 않은 문제를 방지할 수 있다는 점을 배웠습니다. 또한, 기본 설정에 의존하기보다는 상황에 맞게 커스터마이징하는 것이 중요하다는 것을 깨달았습니다.

TISTORYSpring의 WebConfig로 해결한 문자 인코딩의 미스터리

Config 패키지에 WebConfig Class 추가하여 StringHttpMessageConverter를 컨버터 맨앞에 두어 우선실행

🫡 회고

“할 수 있다고 믿으면 가능하다는 신념"

프로젝트에서 저는 Oauth 2.0, OpenAI API, Redis, React Native와 같은 다양한 기술을 접하고, 실제로 적용해보면서 많은 성장을 이뤘습니다. “할 수 있다고 생각하면 할 것이고, 안되면 되게 한다”는 철학을 통해 어려운 문제를 해결하고, 기술적 한계를 극복해 나갔습니다. 문제 해결 능력뿐만 아니라 적극적인 자세를 배우며, 앞으로도 끊임없이 발전하고 성장하는 개발자가 되기 위해 노력할 것입니다.

GitHubGitHub - beyond-sw-camp/be04-4th-PI-MoodHolic: 🌅 김재현 🌅 박경덕 🌅 신동호 🌅 이드보라 🌅 이현우

MoodHolic

트러블 슈팅 2

문제 배경

해결 방법

개선 결과

해당 경험을 통해 알게 된 점

.css-hopgjw{font-family:var(--emoji-font-family);white-space:nowrap;}🫡 회고

🫡 회고