정보

Java Spring Boot 시작하기: Spring Initializr 완벽 사용법 가이드 (웹/CLI)

mindlab091904 2025. 5. 9. 17:47
반응형

 

Java 개발자라면 이제는 선택이 아닌 필수가 되어버린 스프링 부트(Spring Boot). 그중에서도 새 프로젝트를 만들 때 가장 많이 사용되는 도구가 바로 Spring Initializr입니다. 이번 글에서는 Spring Initializr를 이용해 스프링 부트 프로젝트를 생성하는 방법을 웹과 CLI(Command Line Interface) 환경으로 나누어 자세히 설명드리겠습니다. IntelliJ를 활용한 프로젝트 임포트까지 함께 소개하니 처음 스프링을 접하는 분들에게 큰 도움이 될 것입니다.

Spring Initializr란?

Spring Initializr는 스프링 부트 기반의 프로젝트를 쉽고 빠르게 생성할 수 있도록 도와주는 도구입니다. 우리가 자바로 프로젝트를 시작할 때 필요한 디렉터리 구조, 의존성 설정, 기본 설정 파일 등을 자동으로 생성해주기 때문에 생산성을 크게 향상시켜 줍니다.

Spring Initializr는 다음 두 가지 방식으로 사용할 수 있습니다.

  1. 웹 브라우저에서 설정 후 다운로드
  2. CLI에서 명령어로 프로젝트 생성

1. 웹 브라우저에서 스프링 부트 프로젝트 생성하기

웹 방식은 가장 직관적이고 간편한 방법입니다. 초보자뿐 아니라 빠르게 설정하고 싶은 분들도 많이 사용하는 방식입니다.

Step 1. 사이트 접속

아래의 주소로 접속합니다.

🔗 https://start.spring.io

사이트에 접속하면 다양한 옵션이 보이는 초기 화면을 확인할 수 있습니다.

Step 2. 프로젝트 세부 설정

화면에 보이는 항목들을 하나씩 살펴보겠습니다.

✅ Project

  • Maven 또는 Gradle 중 선택
  • 빌드 도구 선택입니다. 초보자는 Maven을 추천하지만 Gradle을 사용할 줄 안다면 속도 측면에서 유리할 수 있습니다.

✅ Language

  • Java, Kotlin, Groovy 중 선택
  • 대부분의 개발자들은 Java를 사용합니다. 특별한 목적이 없다면 Java로 설정하세요.

✅ Spring Boot

  • 사용할 스프링 부트의 버전을 선택합니다.
  • 3.x 버전 이상만 선택 가능하며, SNAPSHOT 버전은 베타 버전이므로 정식 릴리즈 버전을 사용하는 것이 좋습니다.

Step 3. Project Metadata 설정

이 항목은 프로젝트의 기본적인 정보를 입력하는 부분입니다.

  • Group: 패키지 네임의 도메인 앞부분, 예: com.example
  • Artifact: 모듈 또는 프로젝트 이름. 실제로 생성될 .jar/.war 파일 이름이 됩니다.
  • Name: 프로젝트의 이름. 보통 Artifact와 동일하게 설정합니다.
  • Description: 프로젝트 설명
  • Package name: Java 패키지명. 보통 Group.Artifact 형식으로 자동 생성됩니다.
  • Packaging: jar 또는 war 선택. 웹 애플리케이션은 보통 jar을 사용합니다.
  • Java: Java 버전 선택. Spring Boot 3는 Java 17 이상 필수입니다.

Step 4. Dependencies (의존성 추가)

가장 중요한 부분 중 하나입니다. 프로젝트에서 사용할 의존성(Dependencies) 을 추가합니다.

일반적으로 많이 사용하는 항목 예시는 다음과 같습니다:

  • spring-boot-starter-web: 웹 애플리케이션용
  • spring-boot-starter-security: 보안 기능
  • spring-boot-starter-data-jpa: JPA와 데이터베이스 연동
  • spring-boot-starter-thymeleaf: 템플릿 엔진

필요한 의존성을 검색창에서 입력하고 클릭하여 추가합니다.

Step 5. 구성 미리보기

  • Explore 버튼 또는 Ctrl + Space를 누르면 현재 설정된 프로젝트의 파일 구조를 미리 확인할 수 있습니다.
  • Download 버튼: 전체 프로젝트 압축 파일을 다운로드합니다.
  • Copy 버튼: 특정 파일 내용을 클립보드로 복사할 수 있습니다.

Step 6. 프로젝트 다운로드

모든 설정이 완료되면 페이지 하단의 GENERATE 버튼 또는 Ctrl + Enter를 눌러 .zip 파일 형태로 프로젝트를 다운로드 받을 수 있습니다.

2. CLI(명령어)로 프로젝트 생성하기

웹 브라우저 대신 터미널 또는 커맨드라인에서 curl 명령어를 사용해 프로젝트를 생성할 수도 있습니다. CI/CD 환경이나 자동화 스크립트를 만들 때 유용합니다.

curl https://start.spring.io/starter.zip \
-d dependencies=web,security \
-o cli-project.zip
  • -d dependencies=web,security: 사용할 의존성을 쉼표로 구분하여 입력
  • -o cli-project.zip: 저장할 파일명 지정

압축 파일을 받은 뒤, 직접 압축을 풀고 프로젝트에 적용하면 됩니다.

3. IntelliJ로 프로젝트 열기

IntelliJ IDEA는 Spring Boot와 궁합이 잘 맞는 IDE입니다. 다운로드한 zip 파일을 IntelliJ에서 여는 방법도 알아보겠습니다.

Step 1. 압축 풀기

다운로드한 zip 파일의 압축을 풉니다.

이때, 안에 폴더가 한 단계 더 있을 수도 있으니 pom.xml 또는 build.gradle이 존재하는 폴더가 프로젝트 루트라는 점을 기억하세요.

Step 2. IntelliJ에서 열기

  1. IntelliJ를 실행합니다.
  2. 열기(Open)를 선택하고 압축을 푼 프로젝트 폴더를 지정합니다.
  3. 프로젝트를 열면 자동으로 Gradle 또는 Maven 설정이 인식되고 필요한 라이브러리 다운로드가 시작됩니다.
  4. 몇 분 정도 기다리면 세팅이 완료됩니다.

마무리 및 정리

Spring Initializr는 스프링 부트 프로젝트를 매우 간편하고 빠르게 시작할 수 있게 도와주는 강력한 도구입니다. 웹 환경에서는 시각적으로 확인하며 설정할 수 있어 직관적이며, CLI 환경에서는 자동화 및 스크립팅이 가능해 개발 효율을 크게 높일 수 있습니다.

✅ 요약 정리

항목 설명

사이트 https://start.spring.io
설정 방식 웹 UI 또는 CLI
중요 요소 Maven/Gradle, Java 버전, 의존성 설정
Java 버전 최소 17 이상
추천 IDE IntelliJ IDEA
CLI 예시 curl https://start.spring.io/starter.zip -d dependencies=web -o project.zip

추천 의존성 리스트

의존성 설명

spring-boot-starter-web REST API 개발용 필수
spring-boot-starter-security 인증 및 보안
spring-boot-starter-data-jpa 데이터베이스 연동
spring-boot-devtools 개발 편의 기능
spring-boot-starter-thymeleaf HTML 템플릿 렌더링
lombok 반복 코드 최소화
validation 입력 검증용

마치며

Spring Initializr를 제대로 활용하면 프로젝트 초기 세팅 시간을 단축할 수 있을 뿐 아니라, 프로젝트 구조를 더 깔끔하고 일관되게 유지할 수 있습니다. 웹 UI와 CLI 방식을 모두 익혀두면 팀 프로젝트, 개인 사이드 프로젝트, 자동화 배포 등 다양한 상황에서 능숙하게 대처할 수 있습니다.

이제 여러분도 start.spring.io에서 나만의 스프링 부트 프로젝트를 손쉽게 시작해보세요!

 

반응형