정보

[Java] STS 4에서 Spring Boot 3 프로젝트 Import 방법 (Maven & Gradle 완벽 가이드)

mindlab091904 2025. 5. 9. 16:35
반응형

 

Java 기반의 백엔드 개발에서 Spring Boot는 이제 선택이 아닌 필수가 되어가고 있습니다. 특히 Spring Boot 3는 새로운 기능과 향상된 성능으로 많은 개발자들에게 선택받고 있는 버전입니다. 그러나 초보자 또는 기존에 STS(Spring Tool Suite)를 사용해본 경험이 없는 분들에게는, 외부에서 받은 프로젝트(예: GitHub, 사내 저장소 등)를 STS4에 가져오는 과정이 조금은 생소하고 헷갈릴 수 있습니다.

이번 포스팅에서는 **STS 4(Spring Tool Suite 4)**에서 Spring Boot 3 프로젝트를 Import(가져오기) 하는 방법을 Maven과 Gradle 프로젝트 유형에 따라 상세히 안내드리겠습니다. 또한 프로젝트 실행 방법과 자주 발생하는 문제 해결 팁도 함께 제공하니, 끝까지 읽어보시길 추천드립니다.

✅ 사전 준비: STS4와 JDK 설치 확인

먼저 프로젝트를 Import하기 전에 아래 환경이 제대로 준비되어 있어야 합니다.

  • STS 4가 설치되어 있어야 합니다.
  • Java 17 이상 (Spring Boot 3는 최소 JDK 17 필요)
    • JDK 설치 후 환경변수 설정 확인
  • Maven 또는 Gradle 설치는 STS 내장 기능으로 대체 가능하지만, CLI 사용자는 별도 설치 권장

🔷 Maven 기반 프로젝트 Import 방법

Maven은 Java 프로젝트에서 가장 널리 사용되는 빌드 툴입니다. STS4에서는 간단한 몇 단계만 거치면 Maven 프로젝트를 손쉽게 불러올 수 있습니다.

1. 메뉴 경로 진입

STS4를 실행한 후 다음 경로로 이동합니다.

File > Import > Maven > Existing Maven Projects

혹은 아래 경로를 사용해도 동일한 결과를 얻을 수 있습니다.

File > Open Projects from File System
또는
File > Import > General > Projects from Folder or Archive

2. 프로젝트 디렉토리 선택

  • "Root Directory" 항목에서 pom.xml 파일이 위치한 프로젝트 폴더를 선택합니다.
  • 자동으로 Maven 설정을 감지하여 프로젝트를 인식합니다.

3. Finish 클릭

  • 선택한 프로젝트가 올바르면 Finish 버튼을 클릭합니다.
  • Maven Dependency Download가 자동으로 진행되며, IDE 내에서 Maven 빌드 경로 설정이 완료됩니다.

4. Import 완료 확인

  • Package Explorer 또는 Project Explorer에서 프로젝트 구조가 정상적으로 표시되는지 확인합니다.
  • .mvn, pom.xml, src 폴더 등 Maven 기반 디렉토리 구조가 보이면 성공적으로 Import된 것입니다.

🔷 Gradle 기반 프로젝트 Import 방법

Gradle은 속도와 유연성을 강조하는 최신 빌드 도구로, Spring Boot 3와도 아주 잘 어울립니다. Gradle 프로젝트도 STS4에서 쉽게 Import 가능합니다.

방법 1: Existing Gradle Project로 Import

  1. 다음 경로로 이동합니다.
File > Import > Gradle > Existing Gradle Project
  1. 프로젝트 Root Directory 선택 (예: build.gradle 파일이 존재하는 디렉토리)
  2. Next를 눌러 옵션을 확인한 후, Finish 클릭
    • 기본 옵션 그대로 진행해도 무방하며, 상세 옵션 설정이 필요한 경우에는 Next를 통해 추가 설정 가능
  3. 프로젝트 내 Gradle 설정에 따라 필요한 라이브러리들이 자동으로 다운로드됩니다.

방법 2: Projects from File System으로 Import

  1. 상단 메뉴에서
File > Open Projects from File System
  1. “Import Projects from File System or Archive” 창이 열리면 프로젝트 경로를 지정
  2. 자동으로 프로젝트가 감지되며, Finish를 클릭하여 완료

이 방법은 Gradle, Maven 구분 없이 작동하는 범용 Import 방식입니다.

✅ Import 후 프로젝트 실행 방법 (공통)

Maven이든 Gradle이든 프로젝트를 성공적으로 가져온 후에는 아래 방법으로 애플리케이션을 실행할 수 있습니다.

1. 마우스 우클릭 → Run As → Spring Boot App

  • 프로젝트 루트에서 마우스 우클릭
  • Run As > Spring Boot App 클릭

2. 단축키로 실행

Alt + Shift + X, B

이 단축키는 STS4에서 Spring Boot 애플리케이션을 실행하는 기본 키 조합입니다.

3. 실행 로그 확인

실행 후, 하단 Console 탭을 통해 애플리케이션 실행 로그를 확인할 수 있습니다.

. ____  _            __ _ _
/ ___|| |_ ___  _ __ / _(_) | ___  ___
\___ \| __/ _ \| '__| |_| | |/ _ \/ __|
 ___) | || (_) | |  |  _| | |  __/\__ \
|____/ \__\___/|_|  |_| |_|_|\___||___/

이와 같은 Spring Boot 배너와 함께 로그가 출력되면 정상적으로 애플리케이션이 실행된 것입니다.

⚠️ Import 이후 발생할 수 있는 문제 해결

1. Lombok 관련 문제

Spring Boot 프로젝트에서 Lombok(@Getter, @Setter 등)을 사용 중인데도 STS에서 이를 인식하지 못하는 경우가 발생할 수 있습니다.

해결 방법:

  1. Lombok 라이브러리 설치
    • https://projectlombok.org 에서 jar 파일 다운로드
    • java -jar lombok.jar 실행 후 STS 실행 파일 지정
    • STS 재시작
  2. STS에서 프로젝트 우클릭 → Maven > Update Project (Gradle 사용자는 Refresh)

💡 꿀팁: Import 속도 빠르게 하기 위한 팁

  • 인터넷 연결 확인: Maven/Gradle 라이브러리를 외부 저장소에서 받아오기 때문에 연결이 불안정하면 Import 시간이 오래 걸립니다.
  • 캐시 활용: 이미 받아온 라이브러리는 로컬 저장소를 사용하기 때문에 같은 프로젝트를 재설치할 때는 훨씬 빠르게 동작합니다.
  • STS 메모리 설정 조정: STS.ini 파일에서 -Xms, -Xmx 값 증가로 속도 향상 가능

📝 마무리하며

이번 포스팅에서는 STS 4에서 Spring Boot 3 프로젝트를 Import하는 방법을 Maven과 Gradle 각각의 방식으로 상세히 안내드렸습니다. Java와 Spring 생태계는 유연하면서도 복잡한 구조를 가지고 있기 때문에, 프로젝트를 처음 Import할 때는 차근차근 따라가는 것이 중요합니다.

STS4는 Spring에 최적화된 IDE인 만큼, 위 과정을 익혀두면 이후 수많은 스프링 프로젝트를 보다 효율적으로 다룰 수 있습니다. 또한 Import 후 실행이 잘 안 되거나, 의존성 문제가 생길 경우엔 Lombok 설정이나 빌드 툴 설정을 한 번 더 점검해보시기 바랍니다.

 

반응형