🛠️IntelliJ로 스프링부트 백엔드 개발환경 구축하기 (JDK 17 기반)

2025. 5. 29. 18:30Java/SpringBoot

스프링부트 프로젝트를 IntelliJ Community Edition으로 개발하기 위해
JDK 17 설치부터 프로젝트 생성까지 차근차근 진행한 과정을 정리합니다.
모든 설정은 커뮤니티 에디션 기준이며, Postman과 Swagger 연동은 추후 예정입니다.


✅ 1. JDK 17 설치

  • 스프링부트 3.x 이상은 JDK 17 이상이 필수입니다.
  • OpenJDK 17 다운로드 페이지에서 Windows x64 버전 다운로드:
    https://jdk.java.net/17/
  • 설치 후 아래 경로로 정리해두었습니다.
    C:\Program Files\Java\jdk-17.0.0.1

✅ 2. IntelliJ 설치 및 JDK 등록

  • JetBrains 공식 사이트에서 IntelliJ IDEA Community Edition 설치
    https://www.jetbrains.com/idea/download
  • IntelliJ 실행 후 다음 경로에서 JDK 17 등록
    File > Project Structure > SDKs > + > JDK 선택
    경로: C:\Program Files\Java\jdk-17.0.0.1

✅ 3. 스프링부트 프로젝트 생성 (start.spring.io)

IntelliJ 커뮤니티 버전은 Spring Initializr UI 기능이 없기 때문에
start.spring.io 웹사이트를 활용해 프로젝트 생성

  • 사이트: https://start.spring.io
  • 아래 설정으로 압축 파일(.zip) 다운로드
    • Project: Gradle - Groovy
    • Language: Java
    • Spring Boot: 최신 버전 (3.x)
    • Group: com.example
    • Artifact: userapi
    • Java Version: 17
    • Dependencies:
      • Spring Web
      • Spring Data JPA
      • Lombok
      • H2 Database
      • Spring Boot DevTools
  • 다운로드한 zip 파일을 압축 해제하고 폴더 정리
    예: C:\Dev Backend\userapi

✅ 4. IntelliJ에서 프로젝트 열기

  • IntelliJ 실행 > File > Open
  • 위에서 압축 푼 userapi 폴더 선택
  • "Gradle 빌드 스크립트 로드" 메시지가 뜨면 "로드" 클릭
  • 우측 하단에 'Gradle 프로젝트 가져오는 중' 상태 바가 뜨고,
    완료되면 외부 라이브러리까지 모두 적용됨

현재까지 과정은 개발 환경을 안정적으로 구성하는 데 초점을 맞췄습니다.