로그인/세션 관련 문의 대응
고객이 로그인 또는 세션 관련 문제를 신고할 때의 대응 가이드다. UI 화면 기준 증상 → 기술 원인 → 해결 경로 순으로 진행한다.
1. 증상 목록
| # | 고객이 말하는 증상 (UI 기준) | 섹션 |
|---|---|---|
| S-1 | "로그인이 안 됩니다 / 계속 로그인 화면으로 돌아갑니다" | 2.1 |
| S-2 | "로그인했는데 갑자기 로그아웃됩니다" | 2.2 |
| S-3 | "502 Bad Gateway 오류가 납니다" | 2.3 |
2. 증상별 대응 가이드
2.1 S-1: 로그인이 안 된다
증상: 로그인 화면(/auth/signin)에서 ID/PW 입력 후 로그인 버튼 클릭 시 다시 로그인 화면으로 돌아온다. 또는 로그인 직후 무한 리다이렉트가 발생한다.
고객에게 확인
- 어떤 브라우저를 사용하는가? (Chrome/Firefox/Edge/Safari)
- 브라우저 콘솔(F12)에 어떤 에러 메시지가 표시되는가?
- 다른 PC에서도 같은 현상인가?
- 최근 계정 정보 변경(비밀번호, 역할) 이력이 있는가?
기술지원 확인
- nginx 에러 로그에서 세션 헤더 초과 여부 확인:
docker exec flowkat-ui-server cat /var/log/nginx/error.log | grep "too big header"
- Next.js 직접 접근으로 nginx 우회 확인:
docker exec flowkat-ui-server wget -q -O- http://127.0.0.1:3000/api/auth/session
# null 반환 시 Next.js 정상, nginx 설정 문제
- nginx 프록시 버퍼 설정 확인:
docker exec flowkat-ui-server grep -n "proxy_buffer" /etc/nginx/http.d/default.conf
# proxy_buffer_size 16k 설정 확인
확인 포인트:
| 확인 항목 | 정상 상태 | 비정상 상태 |
|---|---|---|
| nginx 에러 로그 | 해당 메시지 없음 | upstream sent too big header |
/api/auth/session 응답 | 200 또는 null | 502 Bad Gateway |
| 프록시 버퍼 | proxy_buffer_size 16k | 기본값 4k/8k |
벤더 에스컬레이션 시 전달 정보
- nginx 에러 로그 전문:
docker exec flowkat-ui-server cat /var/log/nginx/error.log - 브라우저 Network 탭 캡처 (
/api/auth/session요청 응답 코드) - 계정에 할당된 역할 수 및 accessSetting URL 개수
- nginx 설정 파일:
extra/nginx.conf내용 - 증상 발생 시각 및 재현 단계
2.2 S-2: 갑자기 로그아웃된다
증상: 작업 중 갑자기 로그인 화면으로 이동한다. 또는 새 탭 열면 로그아웃 상태다.
고객에게 확인
- 얼마나 자주 발생하는가? (수분 주기, 무작위)
- 특정 메뉴나 동작 후 발생하는가?
- 역할 또는 권한이 최근 변경된 적 있는가?
기술지원 확인
# Dashboard 서버 로그에서 세션 만료 확인
docker compose logs dashboard-server --tail 100 | grep -i "token\|session\|expired"
# UI 서버 로그 확인
docker compose logs ui-server --tail 100 | grep -i "stomp\|auth\|websocket"
확인 포인트:
| 확인 항목 | 정상 상태 | 비정상 상태 |
|---|---|---|
| 세션 토큰 만료 주기 | 24시간 | 수분 이내 만료 |
| WebSocket 연결 | Connected to STOMP server | 403 에러 반복 |
벤더 에스컬레이션 시 전달 정보
- 로그아웃 발생 시각 및 주기
- Dashboard 서버 로그 (로그아웃 발생 전후 5분)
- 브라우저 콘솔 로그 캡처 (F12 > Console)
- NextAuth 세션 쿠키 존재 여부 확인값:
document.cookie.match(/authjs.session-token=([^;]+)/)
2.3 S-3: 502 Bad Gateway 오류
증상: 화면에 502 Bad Gateway 또는 Application error: a client-side exception has occurred 메시지가 표시된다.
고객에게 확인
- 특정 메뉴 접근 시만 발생하는가, 전체적으로 발생하는가?
- 언제부터 발생했는가? (최근 배포 이후 등)
기술지원 확인
# nginx 에러 로그 확인
docker exec flowkat-ui-server tail -50 /var/log/nginx/error.log
# nginx 설정 검증 및 리로드
docker exec flowkat-ui-server nginx -t
docker exec flowkat-ui-server nginx -s reload
nginx 프록시 버퍼 긴급 적용:
docker exec flowkat-ui-server sh -c \
"grep -q 'proxy_buffer_size 16k' /etc/nginx/http.d/default.conf || \
echo ' proxy_buffer_size 16k;' >> /etc/nginx/http.d/default.conf"
docker exec flowkat-ui-server nginx -s reload
벤더 에스컬레이션 시 전달 정보
- nginx 에러 로그 전문
-
extra/nginx.conf파일 전체 - FlowKat 버전 및 배포 일시
- 502 발생 직전 동작 (배포, 설정 변경 등)
3. 관련 문서
| 모듈 | 관련 trouble-shooting | 핵심 이슈 |
|---|---|---|
| nginx 502 | 002-nginx-auth-session-502-fix | proxy_buffer_size, 무한 리다이렉트 |
| 로그아웃 지연 | 026-logout-redirect-optimization | 로그아웃 속도 |