[TIL, 일일 회고] 2024.09.09 - IntelliJ에서 파일 탭이 빨간색으로 표시되는 이유와 해결 방법

개요

 

코드를 작성하다가, 아무런 문제가 없는데, 파일명이 빨간색으로 뜨는 현상이 발생했습니다. (위 그림은 예시입니다.)

 

gpt한테 이유를 물어보니 다음과 같은 경우에 빨간색으로 뜰 수 있다고 했습니다.

1. 의존성 문제

• Gradle이나 Maven에 설정된 의존성이 제대로 적용되지 않았을 수 있습니다. build.gradle 파일의 의존성을 확인하고, IntelliJ에서 Refresh 버튼을 눌러 다시 동기화해보세요.

2. 빌드/컴파일 오류

• 프로젝트를 빌드할 때 오류가 발생하면 상단 탭이 빨간색으로 표시됩니다. Build > Rebuild Project를 선택해 다시 빌드해보세요.
• 빌드 로그에서 발생한 에러 메시지를 확인하고 해당 오류를 해결해야 합니다.

3. 오류 메시지 확인

• Run 탭이나 Event Log 탭에서 발생한 오류 메시지를 확인하세요. 예를 들어, 엔티티 관련 오류가 있거나 잘못된 설정이 있을 수 있습니다.

4. 애노테이션이나 설정 문제

• @Entity, @OneToMany, @ManyToOne 등 애노테이션의 설정에 문제가 있을 수 있습니다. 특히 매핑 관계에서 필드명(mappedBy)이나 JoinColumn 이름 등이 올바르게 설정되었는지 확인해보세요.

5. 캐시 문제

• 때로는 IntelliJ의 캐시 문제로 인해 잘못된 에러 표시가 나타날 수 있습니다. File > Invalidate Caches / Restart를 선택해 캐시를 무효화하고 재시작해보세요.

6. 데이터베이스 설정 확인

• application.yml 또는 application.properties 파일에서 데이터베이스 설정이 제대로 되어 있는지 확인해보세요. 특히 엔티티 관련 클래스들이 데이터베이스와 올바르게 매핑되지 않았을 때 에러가 발생할 수 있습니다.

 

 

그러나 의존성, 어노테이션, 캐시, DB 설정 등 다 확인해보았지만, 전부 이상이 없었기 때문에 좀 더 찾아본 결과 이유는 다음과 같습니다.

 

해당 파일이 Git에 의해 추적되지 않거나, Git의 관리 대상에 포함되지 않는다는 의미입니다.

 

git reset이 원인인 건지 실수로 Git에서 빼버린 건지 정확히는 모르겠지만 어쨋든 Git이 추적하지 못하고있다는 의미였습니다.

 

해결 방법

해결방법에는 2가지가 있습니다. 

 

만약 파일이 Git에 의해 추적되지 않거나 추가되지 않은 경우, git add로 다시 추가하거나, .gitignore를 확인하여 문제를 해결해야 합니다.

 

그러나 Entity 클래스 파일이었기 때문에 .gitignore에 추가되지도 않았습니다. 따라서 git add "파일명"을 해줘서 다시 Git이 추적할 수 있도록 추가하여 해결했습니다..!