[IntelliJ] JPA 사용시 Cannot resolve column' 오류 해결하기

IntelliJ IDEA를 사용하여 Java Persistence API(JPA)를 활용하는 개발자라면, 엔티티의 컬럼이나 테이블명을 변경할 때 나타나는 Cannot resolve column 같은 경고에 익숙할 것입니다. 이러한 경고는 코드상에는 문제가 없음에도 불구하고, IDE에서 빨간색 경고선을 표시하여 불안정한 코드처럼 보이게 만듭니다. 이는 특히 git push와 같은 버전 관리 작업을 할 때 불필요한 스트레스를 줄 수 있습니다. 오늘은 이러한 빨간줄 경고를 해결하는 두 가지 방법을 소개하려고 합니다.

 

1. 대부분의 해결 방법: IntelliJ 설정 변경하기

대다수의 블로그나 포럼, 심지어 StackOverflow에서도 가장 먼저 권장하는 방법은 IntelliJ의 특정 옵션을 비활성화하는 것입니다. 이 방법은 IDE가 수행하는 코드 분석 중 발견된 문제들을 일시적으로 무시하게 만듭니다.

해당 옵션을 비활성화하는 경로는 다음과 같습니다:

▼ 다음과 같은 경로로 해당 옵션을 꺼줍니다.

File > Settings > Editor > Inspections > JPA > Unresolved database reference in annotations

해당 체크를 꺼서 해결한다.

이 설정을 비활성화하면 IntelliJ는 JPA 엔티티와 데이터베이스 스키마 간의 불일치에 대해 더 이상 경고하지 않습니다. 그러나 이 방법의 큰 단점은 실제 데이터베이스 스키마와의 불일치를 놓칠 수 있다는 것입니다.
잘못된 테이블명이나 컬럼명은 런타임 오류로 이어질 수 있기 때문에, 이 방법은 임시적인 해결책일 뿐입니다.

2. 권장하는 해결 방법: 데이터베이스 연결 확인

제 경험에 따르면, IntelliJ에서 제공하는 설정을 변경하는 것보다 더 근본적인 해결책이 있습니다. 이 방법은 IntelliJ의 데이터베이스 연결 기능을 활용하는 것입니다.

(https://stackoverflow.com/questions/43739438/how-to-fix-error-cannot-resolve-column) 참고

데이터베이스 연결 설정하기

1. View > Tool Windows > Database로 이동합니다.

2. 여기에 접속 한 후 configure the db connection 버튼을 누르고 데이터베이스 연결을 설정합니다.

이 과정을 통해 프로젝트에 사용된 데이터베이스에 직접 연결하면, IntelliJ는 실제 데이터베이스 스키마를 기반으로 코드를 분석하게 됩니다. 대부분의 경우, 이 방법만으로도 빨간선 경고가 사라집니다.

3. 예외적인 경우: 엔티티에 정확한 테이블명 명시하기

데이터베이스 연결을 확인했음에도 불구하고 여전히 경고가 사라지지 않는 경우가 있습니다.
이는 내가 실제로 직면했던 상황이기도 하며, 블로그에 글을 쓰는 이유이기도 합니다
이에대해 저는 다음과 같은 해결책을 찾았습니다.

이 문제의 가장 기본적인 해결책은 엔티티에 정확한 테이블 이름을 명시하는 것입니다. 예를 들어, INQUIRY_ANSWER라는 이름의 테이블에 매핑되어야 하는 엔티티 클래스가 있다면, 클래스 선언 부분에 @Table(name = "INQUIRY_ANSWER") 어노테이션을 추가해야 합니다.

import javax.persistence.Entity; 
import javax.persistence.Table; 
@Entity
@Table(name = "INQUIRY_ANSWER") 
public class InquiryAnswer { 
// 클래스 필드와 메소드 }

이렇게 하면 IntelliJ가 엔티티클래스와 데이터베이스를 정확히 매칭을 할 수 있게 도와줘 매핑 오류가 발생하지 않게 됩니다.

IntelliJ IDEA에서 JPA를 사용할 때 발생하는 Cannot resolve column 경고를 해결하는 두가지 방법에 대해 알아봤는데,
개인적으로는 데이터베이스 연결을 확인하고 필요한 경우 엔티티에 정확한 테이블명을 명시하는 방법을 권장합니다.
이러한 접근 방식은 장기적으로 더 안정적인 코드베이스를 유지하는 데 도움이 될 것이라 생각합니당.