F1 Portal — 2026년 3월 14일
3 files+6-8
# F1 Portal 구글 로그인 인증 흐름 개선기
F1 Portal의 구글 로그인 기능에서 발생하던 인증 오류들을 추적하고 해결했습니다. 사용자들이 구글 계정으로 로그인할 때 예기치 않게 실패하는 문제가 있었는데, 원인을 파악하기 위해 먼저 서버 에러 상세 정보와 수신된 이메일을 디버그 로그로 노출시켜 문제를 진단했습니다. 결과적으로 이메일 비교 과정에서 공백과 대소문자 차이로 인한 불일치가 주원인임을 발견할 수 있었습니다.
근본 원인을 파악한 후에는 이메일 정규화(trim + lowercase) 로직을 추가하여 공백과 대소문자 차이를 자동으로 처리하도록 개선했습니다. 동시에 구글 로그인 엔드포인트를 미들웨어 인증 체크에서 제외시켜 불필요한 중복 검증을 제거했고, 디버그 로그들을 정리하여 프로덕션 환경에서 민감한 정보가 노출되지 않도록 처리했습니다.
이번 작업을 진행하며 AI 도구의 도움을 받아 정규화 로직의 엣지 케이스를 검토하고, 미들웨어 흐름을 시각화하는 과정이 문제 해결 속도를 크게 높일 수 있었습니다. 3개 파일의 작은 변경이었지만, 사용자 경험 측면에서는 로그인 성공률 개선이라는 실질적인 가치를 만들어냈습니다.
커밋 기록
cleanup: remove debug error details from Google login
15:14fix: normalize email comparison (trim + lowercase)
15:12debug: show received Google email on auth failure
15:09fix: exclude google-login from middleware auth check
15:06debug: show server error detail in Google login
15:02