[IDE Tip] 테스트 실패 시 로그가 안 보인다면? (Gradle vs IntelliJ 설정)

서론: 빨간색 'FAILED'의 공포

 

우아한테크코스 프리코스 과제를 수행하거나 개인 프로젝트를 진행하면서 테스트 코드(JUnit5)를 작성합니다. 그런데 테스트 실행했더니 터미널 창에 이런 메시지만 덩그러니 뜹니다.

 

>Task :test FAILED There were failing tests. See the report at: file:///.../index.html

"아니..도대체 어디가 틀렸냐구우!" 🤬

 

많은 초보 개발자분들이 여기서 당황하여 브라우저로 index.html 파일을 열어보거나, 터미널 로그를 눈이 빠져라 쳐다봅니다. 하지만 이건 코드를 잘못 짠 게 아니라 개발 환경 설정(Settings) 의 문제입니다.

 

오늘은 인텔리제이(IntelliJ IDEA) 설정을 딱 하나 바꿔서, 디버깅 속도를 10배 빠르게 만드는 방법을 공유합니다.

---

1. 문제의 원인: Gradle의 불친절함

 

인텔리제이에서 프로젝트를 처음 생성하면, 기본적으로 테스트 실행 주체(Test Runner) 가 Gradle 로 설정되어 있습니다.

• Gradle: 빌드 자동화 도구입니다. CI/CD 서버 같은 곳에서 '빌드가 성공했냐 실패했냐'를 판별하는 게 주 목적입니다. 그래서 상세한 비교 화면을 보여주기보다는 결과 통보에 집중합니다.
• IntelliJ: 통합 개발 환경(IDE)입니다. 개발자가 코드를 수정하고 고치는 것을 돕는 게 목적입니다. 그래서 아주 친절한 디버깅 도구를 가지고 있습니다.

우리는 지금 개발을 하고 있으므로, 테스트 실행 권한을 Gradle에게서 뺏어와 IntelliJ에게 줘야 합니다.

---

2. 해결 방법: 3초 컷 설정 변경 🛠️

 

이 설정은 프로젝트를 새로 만들 때마다 꼭 확인해야 하는 필수 설정입니다.

1. 설정(Settings) 창 열기
   • Windows: Ctrl + Alt + S
   • Mac: Cmd + ,
2. Gradle 설정 메뉴로 이동
   • 검색창에 Gradle을 입력하거나,
   • 경로: Build, Excution, Deployment > Build Tools > Gradle 로 이동합니다.
3. Test Runner 변경 (핵심!)
   • Run tests using: 항목을 찾습니다.
   • 기본값: Gradle (Default)
   • 변경값: IntelliJ IDEA로 바꿔줍니다.
   • (참고: 바로 위의 'Build and run using'도 IntelliJ로 바꾸면 빌드 속도가 더 빨라집니다.)

---

변경 후: 신세계가 열립니다 ✨

 

설정을 IntelliJ IDEA로 바꾸고 다시 테스트를 실행(▶)해 보세요. 변화가 느껴지시나요?

 

① 시각적인 결과 비교 (Visual Diff)

터미널의 텍스트 로그 대신, 하단에 전용 테스트 탭이 열립니다. 실패한 테스트를 클릭하면 오른쪽 화면에 Expected(기대값) 와 Actual(실제값) 이 나란히 뜹니다.

 

② Click to see difference

파란색 링크인 Click to see difference를 눌러보세요. 별도의 창이 뜨면서 두 문자열을 비교해 줍니다. 특히 공백(Space) 하나 차이나 줄바꿈(\n) 유무 때문에 실패했을 때, Gradle 로그로는 찾기 힘들지만 IntelliJ 비교 창에서는 빨간색 하이라이트로 정확히 짚어줍니다.

 

③ 빨라진 속도

Gradle을 거치지 않고 IntelliJ가 컴파일된 클래스를 바로 실행하기 때문에, 테스트 시작 속도(Latency)가 훨씬 빠릅니다. TDD(테스트 주도 개발)를 할 때 쾌적함이 다릅니다.

---

+ 보너스 팁: JDK 버전 확인

 

혹시 설정을 바꿨는데도 빌드 자체가 안 된다면 JDK 버전을 확인해야 합니다. 우아한테크코스 및 최신 라이브러리들은 대부분 Java 17 이상을 요구합니다.

• Project Structure (Ctrl + Alt + Shift + S) -> Project -> SDK: 17 이상인지 확인.
• Gradle Settings -> Gradle JVM: 프로젝트 SDK와 버전이 일치하는지 확인.

---

결론

 

"명필은 붓을 가리지 않는다"라는 말이 있지만, 개발자는 붓(도구)을 가려야 합니다. 좋은 도구 설정은 삽질하는 시간을 줄여주고, 우리가 로직 고민에만 집중할 수 있게 도와줍니다.

 

지금 당장 인텔리제이 설정을 확인해 보세요. 빨간색 FAILED 로그가 더 이상 무섭지 않게 될 것입니다.