[일정관리앱 Develop-2] 일정관리앱 Develop 트러블 슈팅

"User CRUD, Schedule CRUD, 세션/쿠키를 활용한 인증/인가" 구현 중 발생한 troubleshooting

---

💥 문제1. 생성자에 final 필드 초기화를 하지 않음

🤯 나의 상황

User 객체를 통째로 받아오면 필드 주입을 안해도 되는줄(?)알았다. (= 자동으로 채워지는 줄 알았다)

 

🥸 문제 상황

✔️ 생성자에 User 객체를 받아 놓고, 아무 필드도 초기화 하지 않았다.
✔️ 필드에 초기화를 하지 않을 경우 userId,UserName,email 모두 null로 남는다.
✔️ 그런데 final이 붙은 필드의 경우 초기화가 되지않으면 컴파일 에러가 발생한다.

 

🔥 문제 코드

@Getter
public class SignUpResponseDto {

    private final Long userId;

    private final String userName;

    private final String email;

    public SignUpResponseDto(User user) {
    	// ❌user를 받기만 하고 final 필드를 초기화하지 않았다.
    }
}

 

🪄 해결 방법

User객체에서 값을 꺼내서 각각 필드에 집어 넣어준다.

 

💧 해결 코드

@Getter
public class SignUpResponseDto {

    private final Long userId;

    private final String userName;

    private final String email;

    public SignUpResponseDto(User user) { 
    	// ☑️ final 필드는 생성자에서 반드시 초기화
    	this.userId = user.getUserId();
        this.userName = user.getUserName();
        this.email = user.getEmail();
    }
}

✏️ final필드는 생성 시 반드시 한 번 초기화되어야 하며, 생성자에서 값을 넣지 않으면 컴파일 에러가 발생한다.

---

💥 문제2. findByEmail()사용 시 선언하지 않아 생긴 오류

🤯 나의 상황

사용자가 입력한 이메일을 기준으로 User정보를 가져오고 싶어서 findById()를 따라 findByEmail()을 사용했는데 오류가 발생했다. findById는 되는데.. 그렇다고 findByEmail을 어디에 선해야하는지도 모르겠다.

 

🥸 문제 상황

✔️ findById()는 JpaRepository가 기본으로 제공하는 메서드라서 아무 선언 없이 사용 가능했다.
✔️ 하지만 findByEmail()과 같이 기본 제공이 아니고,  직접 선언하지 않은 메서드는 바로 사용이 불가능했다.
✔️ 인터페이스에 메서드 시그니처를 명시적으로 선언해야한다.

 

🔥 문제 코드

// ❌ 선언하지 않았는데 바로 사용
User user = userRepository.findByEmail(email)
        .orElseThrow(() -> new RuntimeException("해당 이메일 없음"));

💢 에러 메시지: Cannot resolve method 'findByEmail' in 'UserRepository'

 

🪄 해결 방법

JpaRepository는 findById, findAll과 같은 메서드만 기본 제공하며,
findByEmail, findByUserName과 같은 커스텀 메서드는 인터페이스에서 선언한다.
메서드 이름을 JPA 메서드 네이밍 규칙에 맞춰 작성하면 자동으로 쿼리를 만들어준다.

 

💧 해결 코드

// ✅ UserRepository 인터페이스에 메서드 선언 추가
Optional<User> findByEmail(String email);

User user = userRepository.findByEmail(email)
        .orElseThrow(() -> new RuntimeException("해당 이메일 없음"));

✏️ findBy필드명(데이터타입 필드명) 형식으로 메서드 이름을 지으면, JPA가 자동으로 SQL을 생성해준다.

✏️ 선언하지 않고 사용하면 컴파일에러가 발생하므로, 꼭 인터페이스에 명시적으로 선언한다.

✏️ Optional로 반환하는 이유 : User가 존재하지 않을 수 있기 때문이다.

 

---

💥 문제3. 세션에서 사용한 키를 일치시키지 않아 로그인 처리가 되지 않음

🤯 나의 상황

로그인 후에는 세션이 생성되어야 하니까 session.getAttribute()로 유저를 꺼내오면 정상적으로 필터를 통과할 줄 알았다.
그런데 로그인이 된 것 같은데 "로그인이 필요합니다"라는 에러가 계속 발생했다.

 

🥸 문제 상황

✔️ 로그인 성공 시 세션에 사용자 정보를 저장할 때 user라는 키로 저장했다.
✔️ 그런데 필터에서는 session.getAttribute("sessionKey")로 가져오고 있었다. (실습 코드 따라 쓰느라 ㅠㅠ)
✔️ 즉, 키 이름이 달라서 항상 null이 반환되었던 것이다.

 

🔥 문제 코드

// 로그인 시
session.setAttribute("user", user);

// 필터에서 확인할 때 (❌ 키 이름 다름)
if (session == null || session.getAttribute("sessionKey") == null) {
    throw new RuntimeException("로그인이 필요합니다.");
}

 

🪄 해결 방법

세션에서 값을 꺼낼 때 사용하는 키 이름을, 저장할 때 사용한 키 이름과 정확히 일치시켜야 한다. (둘 다 user로 일치시킨다.)

 

💧 해결 코드

// 로그인 시
session.setAttribute("user", user);

// 필터에서 확인할 때 (✅ 키 이름 일치)
if (session == null || session.getAttribute("user") == null) {
    throw new RuntimeException("로그인이 필요합니다.");
}

✏️ 세션에 저장할 때 사용한 키 이름과, 꺼낼 때 사용하는 키 이름을 반드시 일치해야한다.

✏️ 키가 다르면 null이 반환되어, 인증에 실패하게 된다.

---

❇️ 배운점 요약

• final 필드는 생성 시 반드시 값을 초기화 해줘야한다.
• JpaRepository에서 특정 필드에 따른 값을 찾고 싶을때는 findBy필드명() 함수를 인터페이스에 선언한다.
• 세션을 활용해 인증처리를 할 때 key값을 반드시 일치시키도록 확인한다.