테스트코드 실행 시 버전 에러 - Unsupported class file major version, Error while instrumenting with JaCoCo

새로 추가된 기능들이 있어서, 오랜만에 통합 테스트를 추가하고 실행하는데 에러가 발생했다. 스프링 어플리케이션 자체 실행에는 문제가 없고 테스트는 정상적으로 실행되지만, 테스트 로그에는 엄청난 양의 에러 로그가 남고 Build 결과에도 에러가 가득했다.

트러블 슈팅

현상 분석

에러 로그가 엄청나게 길지만 결국 아래 로그가 반복되고 있었다.

java.lang.instrument.IllegalClassFormatException: Error while instrumenting sun/security/ec/SunEC$1 with JaCoCo 0.8.8.202204050719/5dcf34a.
    at org.jacoco.agent.rt.internal_b6258fc.CoverageTransformer.transform(CoverageTransformer.java:94)
    at java.instrument/java.lang.instrument.ClassFileTransformer.transform(ClassFileTransformer.java:244)
    at java.instrument/sun.instrument.TransformerManager.transform(TransformerManager.java:188)
    at java.instrument/sun.instrument.InstrumentationImpl.transform(InstrumentationImpl.java:610)
~~~~
    at org.gradle.process.internal.worker.child.SystemApplicationClassLoaderWorker.call(SystemApplicationClassLoaderWorker.java:113)
    at org.gradle.process.internal.worker.child.SystemApplicationClassLoaderWorker.call(SystemApplicationClassLoaderWorker.java:65)
    at worker.org.gradle.process.internal.worker.GradleWorkerMain.run(GradleWorkerMain.java:69)
    at worker.org.gradle.process.internal.worker.GradleWorkerMain.main(GradleWorkerMain.java:74)
Caused by: java.io.IOException: Error while instrumenting sun/security/ec/SunEC$1 with JaCoCo 0.8.8.202204050719/5dcf34a.
    at org.jacoco.agent.rt.internal_b6258fc.core.instr.Instrumenter.instrumentError(Instrumenter.java:161)
    at org.jacoco.agent.rt.internal_b6258fc.core.instr.Instrumenter.instrument(Instrumenter.java:111)
    at org.jacoco.agent.rt.internal_b6258fc.CoverageTransformer.transform(CoverageTransformer.java:92)
    ... 176 more
Caused by: java.lang.IllegalArgumentException: Unsupported class file major version 65
    at org.jacoco.agent.rt.internal_b6258fc.asm.ClassReader.<init>(ClassReader.java:199)
    at org.jacoco.agent.rt.internal_b6258fc.asm.ClassReader.<init>(ClassReader.java:180)
    at org.jacoco.agent.rt.internal_b6258fc.asm.ClassReader.<init>(ClassReader.java:166)
    at org.jacoco.agent.rt.internal_b6258fc.core.internal.instr.InstrSupport.classReaderFor(InstrSupport.java:280)
    at org.jacoco.agent.rt.internal_b6258fc.core.instr.Instrumenter.instrument(Instrumenter.java:77)
    at org.jacoco.agent.rt.internal_b6258fc.core.instr.Instrumenter.instrument(Instrumenter.java:109)
    ... 177 more

두 가지 문장 정도가 에러의 핵심으로 보인다.

• java.lang.instrument.IllegalClassFormatException: Error while instrumenting sun/security/ec/SunEC$1 with JaCoCo 0.8.8.202204050719/5dcf34a.
• Caused by: java.lang.IllegalArgumentException: Unsupported class file major version 65

원인 분석

로그 상으로는 JaCoCO가 원인인 것 같아 해당 로그를 통해 찾아봤지만 그럴듯한 내용은 전혀 없었다. Unsupported class ~ 를 통해서 찾아보니, 스프링 부트와 맞지 않은 JDK를 사용해서라고 하지만 스프링 어플리케이션 실행에는 문제가 없고 프로젝트 생성할 때 Spring boot 3 버전에 맞는 JDK로 설치했다. 혹시 몰라 JDK를 변경해봤는데, 오히려 더 낮은 버전의 JDK로 변경하자 해결되었다.

• JDK 20 적용 → ❌ Unsupported class file major version 64
• JDK 21 적용 → ❌ Unsupported class file major version 65
• JDK 17 → ✅ 성공

원인이 파악되지 않아 혼란스러웠는데, 특히 JaCoCo가 너무 뜬금없이 로그에 있어서 더 혼란스러웠다. 고민하던 중 JaCoCO와 호환되지 않는 JDK라는 뜻은 아닐까 의심이 들어서 JacCoCo 호환성을 찾아봤더니 정답이였다. 사용하고 있는 0.8.8에서 JDK 17, 18을 지원하기 시작했으니, 지원하지 않는 JDK를 사용하고 있었다.

---

해결 방법

프로젝트 SDK로 사용되는 JDK 버전을 인텔리지에서 변경하면 된다.

1. File > Project Structure > Project Settings > Project
   • SDK 변경
   • Language level 변경

 

  2. Intellij IDEA > Settings > Build, Execution, Deployment > Build Tools > Gradle > Gradle JVM 변경

 

 

그럼 해결된다. 🥳
JDK 버전 호환 트러블슈팅에 대한 자료는 있지만, JaCoCo로 인해 JDK 버전 호환에 대한 자료는 없어서 작성해보았다.