<div id="readability-page-1" class="page"><div><article>
<p data-ke-size="size16">스프링 부트 3.0 이 출시되었다. <br>(현재 최신은 3.0.1 이지만)</p>
<p data-ke-size="size16">3.0 부터는 <b>Java 17부터 지원</b>된다. <br>그러다보니 기존에 Java8, 11등을 사용하시던 분들은 3.x 스프링 부트 프로젝트를 실행할때 에러들을 만나게 되는데, 이번에 나도 똑같이 경험해서 정리하게 되었다.</p>
<h2 id="문제" data-ke-size="size26">문제</h2>
<p data-ke-size="size16">스프링 부트 3.0.1 프로젝트를 실행할 일이 생겼다. <br>그래서 기존에 설치된 IntelliJ에서 Gradle Import를 시켰더니 다음과 같이 방다한 에러 메세지와 함께 실행이 되지 않았다.</p>
<blockquote data-ke-style="style1">
<p data-ke-size="size16">기존 노트북에서 모두 Java 11로 프로젝트를 구동시켰었다.</p>
</blockquote>
<pre data-ke-language="java"><code>No matching variant of org.springframework.boot:spring-boot-gradle-plugin:3.0.1 was found. The consumer was configured to find a runtime of a library compatible with Java 16, packaged as a jar, and its dependencies declared externally, as well as attribute 'org.gradle.plugin.api-version' with value '7.6' but:
          - Variant 'apiElements' capability org.springframework.boot:spring-boot-gradle-plugin:3.0.1 declares a library, packaged as a jar, and its dependencies declared externally:
              - Incompatible because this component declares an API of a component compatible with Java 17 and the consumer needed a runtime of a component compatible with Java 16
              - Other compatible attribute:
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'javadocElements' capability org.springframework.boot:spring-boot-gradle-plugin:3.0.1 declares a runtime of a component, and its dependencies declared externally:
              - Incompatible because this component declares documentation and the consumer needed a library
              - Other compatible attributes:
                  - Doesn't say anything about its target Java version (required compatibility with Java 16)
                  - Doesn't say anything about its elements (required them packaged as a jar)
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'mavenOptionalApiElements' capability org.springframework.boot:spring-boot-gradle-plugin-maven-optional:3.0.1 declares a library, packaged as a jar, and its dependencies declared externally:
              - Incompatible because this component declares an API of a component compatible with Java 17 and the consumer needed a runtime of a component compatible with Java 16
              - Other compatible attribute:
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'mavenOptionalRuntimeElements' capability org.springframework.boot:spring-boot-gradle-plugin-maven-optional:3.0.1 declares a runtime of a library, packaged as a jar, and its dependencies declared externally:
              - Incompatible because this component declares a component compatible with Java 17 and the consumer needed a component compatible with Java 16
              - Other compatible attribute:
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'runtimeElements' capability org.springframework.boot:spring-boot-gradle-plugin:3.0.1 declares a runtime of a library, packaged as a jar, and its dependencies declared externally:
              - Incompatible because this component declares a component compatible with Java 17 and the consumer needed a component compatible with Java 16
              - Other compatible attribute:
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'sourcesElements' capability org.springframework.boot:spring-boot-gradle-plugin:3.0.1 declares a runtime of a component, and its dependencies declared externally:
              - Incompatible because this component declares documentation and the consumer needed a library
              - Other compatible attributes:
                  - Doesn't say anything about its target Java version (required compatibility with Java 16)
                  - Doesn't say anything about its elements (required them packaged as a jar)
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')</code></pre>
<p data-ke-size="size16">그래서 이런 에러들이 나온다면 다음의 방법들을 시도해보자.</p>
<h2 id="해결" data-ke-size="size26">해결</h2>
<p data-ke-size="size16">이 문제의 해결책으로 <b>스프링 부트 2.7.x 로 다운그레이드</b> 하면된다는 글들도 몇개 발견하였다. <br>그건 원하던 해결책이 아니라서 이 글에서는 완전히 배제한다.</p>
<h3 id="1-java" data-ke-size="size23">1. Java</h3>
<p data-ke-size="size16">스프링 부트 3.0 부터는 Java 17이 필수다. <br>그래서 현재 설치된 Java 버전이 무엇인지 확인해보고 <b>17버전 이상인지</b> 확인 후, 그 이하라면 17 이상을 설치한다.</p>
<pre><code>java -version</code></pre>
<br><img src="https://blog.kakaocdn.net/dn/V1ftD/btrWQqovdkj/YE1fwPW0S9yrKsb9UjbIe0/img.png" alt="java">
<p data-ke-size="size16">Java 17 이상인데도 여전히 프로젝트의 오류가 그대로 발생한다면 다른 설정들을 확인해본다.</p>
<h3 id="2-buildgradle" data-ke-size="size23">2. build.gradle</h3>
<p data-ke-size="size16">해당 프로젝트의 <code>sourceCompatibility</code> 가 17이상으로 되어있는지 확인한다.</p>
<img src="https://blog.kakaocdn.net/dn/nT5yY/btrWQXTBHeA/nfa7Kl0b2LQRxkrUNZUbrk/img.png" alt="gradle">
<pre><code>sourceCompatibility = '17'</code></pre>

<p data-ke-size="size16">이 설정까지 해도 안된다면, IntelliJ 설정이 안되어있을 확률이 높다.</p>
<h3 id="3-intellij" data-ke-size="size23">3. IntelliJ</h3>
<p data-ke-size="size16">결국 이 프로젝트를 실행하는 <b>IntelliJ가 프로젝트를 Java 17로 실행</b>해야만 한다.</p>
<p data-ke-size="size16">그래서 아래 설정들을 따라 Java 17 이상으로 IntelliJ를 설정한다.</p>
<h4 id="3-1-gradle-build" data-ke-size="size20">3-1. Gradle Build</h4>
<p data-ke-size="size16">IntelliJ의 <code>Preferences/Settings</code> -&gt; <code>Build, Execution, Deployment</code> -&gt; <code>Build Tools</code> -&gt; <code>Gradle</code> 로 이동한다.</p>
<p data-ke-size="size16">그럼 아래와 같이 Gradle 설정이 나오는데, 이때 <b>Gradle의 JVM이 Java 17이상인지</b> 확인한다.</p>
<img src="https://blog.kakaocdn.net/dn/cpUIiY/btrWQbLPlIE/symGN2Khk88xuXD5kdtiOk/img.png" alt="ij1">
<p data-ke-size="size16">만약 17이상이 아니라면 17이상으로 설정한다.</p>
<h4 id="3-2-project-sdk" data-ke-size="size20">3-2. Project SDK</h4>
<p data-ke-size="size16">다음으로 <code>File</code> -&gt; <code>Project Structure..</code> 로 이동하여 프로젝트 SDK의 버전을 확인후 Java 17이상으로 설정한다.</p>
<img src="https://blog.kakaocdn.net/dn/NfFrJ/btrWQe2OESh/2ggXdXvzmql6DM6NfXAC6k/img.png" alt="ij2"> 
<p data-ke-size="size16"><b>Project</b></p>
<img src="https://blog.kakaocdn.net/dn/EEY16/btrWQLeIYvg/6vi89mXx6mXz6ZKPTtVPz0/img.png" alt="ij3"> 
<p data-ke-size="size16"><b>Modules</b></p>
<img src="https://blog.kakaocdn.net/dn/bHoahu/btrWQdJAY70/wTAWFWeKww6kutUn5bi4t1/img.png" alt="ij4">
<h3 id="gradle-refresh" data-ke-size="size23">Gradle Refresh</h3>
<p data-ke-size="size16">IntelliJ까지 설정이 모두 끝났다면 다시 Gradle Refresh를 실행해보자.</p>
<img src="https://blog.kakaocdn.net/dn/c4wAoI/btrWRcJM3Iq/aTNk0ixfjE5kGEC0OaQxY0/img.png" alt="result1">
<p data-ke-size="size16">그럼 이제 다음과 같이 정상적으로 빌드가 되는 것을 확인할 수 있다.</p>
<img src="https://blog.kakaocdn.net/dn/bujx0p/btrWRWTQ1Vb/RGgkDvfv18GpjKntIYxpa1/img.png" alt="result2"></article></div></div>

기억보단 기록을

이동욱 (향로)

스프링 부트 3.0 이 출시되었다. 
(현재 최신은 3.0.1 이지만)
3.0 부터는 Java 17부터 지원된다. 
그러다보니 기존에 Java8, 11등을 사용하시던 분들은 3.x 스프링 부트 프로젝트를 실행할때 에러들을 만나게 되는데, 이번에 나도 똑같이 경험해서 정리하게 되었다.
문제
스프링 부트 3.0.1 프로젝트를 실행할 일이 생겼다. 
그래서 기존에 설치된 IntelliJ에서 Gradle Import를 시켰더니 다음과 같이 방다한 에러 메세지와 함께 실행이 되지 않았다.
기존 노트북에서 모두 Java 11로 프로젝트를 구동시켰었다.
No matching variant of org.springframework.boot:spring-boot-gradle-plugin:3.0.1 was found. The consumer was configured to find a runtime of a library compatible with Java 16, packaged as a jar, and its dependencies declared externally, as well as attribute 'org.gradle.plugin.api-version' with value '7.6' but:
          - Variant 'apiElements' capability org.springframework.boot:spring-boot-gradle-plugin:3.0.1 declares a library, packaged as a jar, and its dependencies declared externally:
              - Incompatible because this component declares an API of a component compatible with Java 17 and the consumer needed a runtime of a component compatible with Java 16
              - Other compatible attribute:
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'javadocElements' capability org.springframework.boot:spring-boot-gradle-plugin:3.0.1 declares a runtime of a component, and its dependencies declared externally:
              - Incompatible because this component declares documentation and the consumer needed a library
              - Other compatible attributes:
                  - Doesn't say anything about its target Java version (required compatibility with Java 16)
                  - Doesn't say anything about its elements (required them packaged as a jar)
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'mavenOptionalApiElements' capability org.springframework.boot:spring-boot-gradle-plugin-maven-optional:3.0.1 declares a library, packaged as a jar, and its dependencies declared externally:
              - Incompatible because this component declares an API of a component compatible with Java 17 and the consumer needed a runtime of a component compatible with Java 16
              - Other compatible attribute:
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'mavenOptionalRuntimeElements' capability org.springframework.boot:spring-boot-gradle-plugin-maven-optional:3.0.1 declares a runtime of a library, packaged as a jar, and its dependencies declared externally:
              - Incompatible because this component declares a component compatible with Java 17 and the consumer needed a component compatible with Java 16
              - Other compatible attribute:
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'runtimeElements' capability org.springframework.boot:spring-boot-gradle-plugin:3.0.1 declares a runtime of a library, packaged as a jar, and its dependencies declared externally:
              - Incompatible because this component declares a component compatible with Java 17 and the consumer needed a component compatible with Java 16
              - Other compatible attribute:
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
          - Variant 'sourcesElements' capability org.springframework.boot:spring-boot-gradle-plugin:3.0.1 declares a runtime of a component, and its dependencies declared externally:
              - Incompatible because this component declares documentation and the consumer needed a library
              - Other compatible attributes:
                  - Doesn't say anything about its target Java version (required compatibility with Java 16)
                  - Doesn't say anything about its elements (required them packaged as a jar)
                  - Doesn't say anything about org.gradle.plugin.api-version (required '7.6')
그래서 이런 에러들이 나온다면 다음의 방법들을 시도해보자.
해결
이 문제의 해결책으로 스프링 부트 2.7.x 로 다운그레이드 하면된다는 글들도 몇개 발견하였다. 
그건 원하던 해결책이 아니라서 이 글에서는 완전히 배제한다.
1. Java
스프링 부트 3.0 부터는 Java 17이 필수다. 
그래서 현재 설치된 Java 버전이 무엇인지 확인해보고 17버전 이상인지 확인 후, 그 이하라면 17 이상을 설치한다.
java -version
Java 17 이상인데도 여전히 프로젝트의 오류가 그대로 발생한다면 다른 설정들을 확인해본다.
2. build.gradle
해당 프로젝트의 sourceCompatibility 가 17이상으로 되어있는지 확인한다.
sourceCompatibility = '17'
이 설정까지 해도 안된다면, IntelliJ 설정이 안되어있을 확률이 높다.
3. IntelliJ
결국 이 프로젝트를 실행하는 IntelliJ가 프로젝트를 Java 17로 실행해야만 한다.
그래서 아래 설정들을 따라 Java 17 이상으로 IntelliJ를 설정한다.
3-1. Gradle Build
IntelliJ의 Preferences/Settings -> Build, Execution, Deployment -> Build Tools -> Gradle 로 이동한다.
그럼 아래와 같이 Gradle 설정이 나오는데, 이때 Gradle의 JVM이 Java 17이상인지 확인한다.
만약 17이상이 아니라면 17이상으로 설정한다.
3-2. Project SDK
다음으로 File -> Project Structure.. 로 이동하여 프로젝트 SDK의 버전을 확인후 Java 17이상으로 설정한다.
 
Project
 
Modules
Gradle Refresh
IntelliJ까지 설정이 모두 끝났다면 다시 Gradle Refresh를 실행해보자.
그럼 이제 다음과 같이 정상적으로 빌드가 되는 것을 확인할 수 있다.

Spring Boot 3.x 실행이 안될 경우 (feat. IntelliJ)

댓글