스프링 부트 개발 환경 설정 가이드

JHLee·2025년 3월 14일

Springboot

목록 보기

1/6

이 글에서는 스프링 부트 개발을 시작하기 위한 필수 환경 설정 방법을 다룹니다.
(JDK 설치, IntelliJ IDEA 설정, 프로젝트 생성)
📖 참고 자료 : 코딩 자율학습 스프링 부트 3 자바 백엔드 개발 입문

1. 스프링 부트란?

스프링 부트(Spring Boot)는 자바 웹 애플리케이션을 쉽고 빠르게 개발할 수 있도록 돕는 프레임워크입니다.
다양한 설정이 자동화되어 있어 개발자가 효율적으로 애플리케이션을 구축할 수 있습니다.
(예: 프랜차이즈 시스템 구축 시 공통 기능을 쉽게 설정 가능)

2. 스프링 부트 개발 환경 설정

2.1 JDK 17 설치

JDK(Java Development Kit): 자바 코드의 컴파일과 실행을 담당하는 개발 도구

📌MacOS에서 JDK 17 설치

1) Homebrew 설치
홈브루(Hombrew) 는 macOS에서 패키지를 간편하게 설치할 수 있도록 도와주는 관리 도구입니다.
터미널을 열고 아래 명령어를 입력하여 Homebrew를 설치합니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2) OpenJDK 17 설치
Homebrew가 설치되었다면, 다음 명령어로 OpenJDK 17을 설치합니다.

brew install openjdk@17

3) JDK 17을 시스템에 연결
설치한 JDK가 시스템에서 인식될 수 있도록 아래 명령어를 실행합니다.

sudo ln -sfn /opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-17.jdk
echo 'export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc

4) 설치 확인
터미널을 다시 실행한 후, 아래 명령어를 입력하여 JDK가 정상적으로 설치되었는지 확인합니다.

java --version

정상적으로 설치되었다면, "openjdk 17.0.x" 와 같은 메시지가 출력됩니다.

📌Windows에서 JDK 17 설치

1) JDK 다운로드 및 설치
1. AdoptiumOpenJDK 홈페이지에 접속합니다.
2. Operating System에서 Windows를 선택합니다.
3. Architecture에서 x64 또는 ARM64를 선택한 후 JDK 17 버전을 선택합니다.
4. [.msi] 버튼을 클릭하여 설치 파일을 내려받아 실행합니다.

2) 환경 변수 설정
설치가 완료되면 JDK를 정상적으로 사용할 수 있도록 환경 변수를 설정해야 합니다.

윈도우 키 + R을 눌러 "sysdm.cpl"을 입력하고 엔터를 누릅니다.
고급 탭에서 환경 변수 버튼을 클릭합니다.
시스템 변수에서 Path 항목을 찾아 편집 버튼을 클릭합니다.
새 항목을 추가 (새로 만들기 클릭)하고, 설치된 JDK의 bin 경로를 입력합니다.

C:\Program Files\Eclipse Adoptium\jdk-17\bin

모든 창을 확인 버튼을 눌러 닫고 적용합니다.

3) 설치 확인
커맨드 프롬프트(CMD)를 열고 아래 명령어를 입력하여 JDK가 정상적으로 설치되었는지 확인합니다.

java --version

정상적으로 설치되었다면, "openjdk 17.0.x" 와 같은 메시지가 출력됩니다.

2.2 IntelliJ IDEA 설치

IDE(Integrated Development Environment): 개발 생산성을 높여주는 통합 개발 환경
대표적인 IDE : Eclipse, IntelliJ IDEA

IntelliJ IDEA 설치 방법
1. 인텔리제이 다운로드 페이지에 접속합니다.
2. Community Edition(무료 버전)의 [다운로드] 버튼을 클릭하여 설치 파일을 받습니다.
3. 다운로드한 파일을 실행하여 설치를 완료합니다.

2.3 스프링 부트 프로젝트 생성 (Spring Initializr 활용)

1 ) Spring Initializr 설정
1. Spring Initializr 페이지에 접속합니다.
2. 아래와 같이 프로젝트 설정을 합니다.

Project: Gradle - Groovy
Language: Java
Spring Boot: 3.1.0 (없으면 기본값 선택)
Packaging: Jar
Java: 17 (설치한 JDK 버전 선택)

프로젝트 이름(Artifact)을 입력하고, 필요한 Dependencies(의존성)을 추가합니다.
- Spring Web
- H2 Database (경량 데이터베이스)
- Mustache (템플릿 엔진)
- Spring Data JPA (ORM 프레임워크)
[GENERATE] 버튼을 클릭하여 프로젝트를 다운로드합니다.

2 ) IntelliJ에서 프로젝트 열기
1. 다운로드한 압축 파일을 해제한 후, IntelliJ IDEA에서 해당 폴더를 엽니다.
2. 프로젝트를 처음 실행하면 필요한 파일들이 자동으로 다운로드되며, 빌드가 완료되면 "BUILD SUCCESSFUL" 메시지가 출력됩니다.

3. 프로젝트 디렉터리 구조 탐색

스프링 부트 프로젝트를 생성하면 기본적인 디렉터리 구조가 자동으로 생성됩니다.

src/main/java: 자바 코드가 저장되는 디렉터리
src/main/resources: 설정 파일 및 정적 파일이 저장되는 디렉터리
com.example.프로젝트명: 애플리케이션의 기본 패키지

4. "Hello, World!" 출력하기

프로젝트가 정상적으로 실행되는지 확인하기 위해 간단한 "Hello, World!" 메시지를 출력해보겠습니다.


import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, World!";
    }
}