[개발일지] Spring Boot 세션 문제 해결기: "왜 자꾸 로그인이 풀리지?" 객체를 세션에 저장할 때 발생하는 문제

📖 들어가며

안녕하세요! 오늘은 Spring Boot 프로젝트 개발 중 겪었던 세션 관련 문제와 해결 과정을 공유하려고 합니다.

개발자라면 누구나 한 번쯤 겪어봤을 문제일 텐데요, "코드 수정할 때마다 로그인이 풀려서 다시 로그인해야 하는 그문제" 

---

🚨 문제 발생: "또 로그인이 풀렸네?"

상황

Spring Boot + Thymeleaf로 웹 애플리케이션을 개발하고 있었는데, 코드를 수정하고 저장할 때마다 다음과 같은 현상이 발생했습니다:

1. 로그인 완료 ✅
2. 개발 작업 중... 💻
3. 코드 수정 후 저장 📝
4. DevTools가 자동으로 애플리케이션 재시작 🔄
5. 브라우저에서 페이지 새로고침 🌐
6. "권한이 없습니다" 에러 + 로그인 페이지로 리다이렉트 😱

얼마나 귀찮았냐면...

• 하루에 몇십 번씩 다시 로그인 😭
• 개발 흐름이 계속 끊어짐
• 집중력 저하로 생산성 급감

특히 권한 시스템을 개발하고 있었는데, 권한별로 다른 화면을 테스트하려면 매번 다시 로그인해야 하니까 정말 스트레스였어요!

---

🔍 원인 탐구: "뭔가 이상한데?"

이상한 건 세션에서 일부 데이터만 사라진다는 점이었어요:

// 세션 확인 결과
session.getAttribute("accessToken")           // ✅ 있음
session.getAttribute("isMasterPrivilege")     // ✅ 있음  
session.getAttribute("pageAccessRightSettings") // ❌ 없음!!

"뭐지? 왜 일부만 사라지지?" 🤔

---

🧐 범인을 찾아라: Serializable의 배신

가설 설정

일부 데이터만 사라진다는 건 직렬화(Serialization) 문제일 가능성이 높다고 생각했습니다.

코드 확인

// String 타입들 (기본 직렬화 가능)
String accessToken = "JWT토큰";           // ✅ 
String isMasterPrivilege = "1";           // ✅

// 사용자 정의 객체 (의심스러운 녀석)
PageAccessRightSettings pageSettings = new PageAccessRightSettings(); // ❌?

범인 발견!

PageAccessRightSettings 클래스를 확인해보니:

@Data
public class PageAccessRightSettings {
    // ❌ Serializable 구현 안됨!
    private String monitoringPage;
    private String userManagementPage;
    private String deviceManagementPage;
    // ...
}

바로 이것이었습니다! 💡

왜 이런 일이 발생하나?

1. Spring DevTools 재시작 → 애플리케이션 컨텍스트 새로 생성
2. 세션 데이터 직렬화 시도 → String은 성공, 사용자 객체는 실패
3. 직렬화 실패한 객체만 세션에서 제거
4. 권한 체크 시 pageAccessRightSettings 없음 → 인증 실패

---

🛠️ 해결 과정: "이렇게 해보자!"

해결책 : Serializable 구현 ⭐️⭐️⭐️⭐️⭐️

@Data
public class PageAccessRightSettings implements Serializable {
    private static final long serialVersionUID = 1L;
    
    private String monitoringPage;
    private String userManagementPage;
    private String deviceManagementPage;
    private String userSendPage;
    private String accessHistoryPage;
    private String schedulePage;
    private String groupManagementPage;
    private String clientSettingPage;
}

 

---

🎯 최종 해결: "드디어 평화가 왔다!"

적용 결과

1. Serializable 구현 → 세션에서 권한 정보 사라지지 않음 ✅

테스트 결과

✅ 코드 수정 후 저장
✅ DevTools 자동 재시작  
✅ 브라우저 새로고침
✅ 로그인 상태 유지! (권한 정보 포함)
✅ 개발 작업 계속 진행 가능!

성능 향상

• 로그인 횟수: 하루 30회 → 1회 😎
• 개발 집중도: 대폭 향상 📈
• 스트레스 지수: 급감 😌

---

💡 배운 점들

1. Java 직렬화의 중요성

// 세션에 저장할 객체는 반드시 Serializable 구현!
public class MyData implements Serializable {
    private static final long serialVersionUID = 1L;
    // ...
}

 

 

 

🎉 마무리

이번 문제를 해결하면서 "작은 것이 큰 차이를 만든다"는 것을 다시 한번 느꼈습니다.

implements Serializable 한 줄 추가로:

• 개발 효율성 대폭 향상 📈
• 스트레스 해소 😌
• 새로운 지식 습득 🧠

개발자 여러분께 드리는 팁 💬

1. 세션에 저장할 객체는 꼭 Serializable 구현하세요!
2. 개발 환경의 작은 불편함도 무시하지 마세요
3. 문제 해결 과정에서 근본 원인을 찾는 습관을 기르세요

혹시 비슷한 문제로 고생하고 계신 분들께 도움이 되었으면 좋겠습니다!

질문이나 다른 해결 방법이 있으시면 댓글로 공유해주세요~ 🙌

 

#Spring Boot #세션관리 #DevTools #Serializable #개발일지 #문제해결 #Java #백엔드개발