[Spring Boot] 프로젝트 생성 및 실행하기

Spring Boot

Spring Boot는 기존의 Spring Framework와 달리 복잡한 설정을 최소화하여 웹 프로그램을 쉽고 빠르게 만들 수 있게 설계된 자바의 웹 프레임워크다.

이 글에서 Spring Boot 프로젝트를 생성하고 실행하는 방법을 알아보자. (개발 도구: IntelliJ)

 

 

 

1. 프로젝트 생성

Spring Boot 프로젝트를 쉽게 생성할 수 있도록 도와주는 Spring Initializr 사이트로 이동한다.

 

프로젝트 환경에 맞게 작성한다.

 

Project: Maven와 Gradle 중 선택
Language: Java
Spring Boot 버전: 안정화된 최신 버전 선택 (default 그대로 유지)
Project Metadata:
Group: 프로젝트 도메인
Artifact: 프로젝트 이름
Name: Name은 Artifact의 이름을 따라감
Description: 간단한 설명
Package name: 자동 생성됨
Packaging: Jar와 War 중 선택
Java 버전: Java 버전 선택 (java --version으로 현재 버전 확인)

 

Dependencies(의존성)은 Spring Web, Lombok, Spring Data JPA, H2 Database, MySQL Driver 등 필요한 것들을 추가한다.

 

모든 설정을 마치고 Generate 버튼을 누르면 프로젝트가 zip 파일로 다운로드된다.
압축 풀고 IntelliJ에서 Open한다.

 

 

 

2. 프로젝트 실행

src/main/java/com.example/ProjectApplication.java

해당 경로에 있는 ProjectApplication 클래스의 main 메서드를 실행한다.

 

의존성에 Spring Web를 추가했고 8080포트를 사용중이 아니라면 정상적으로 서버가 실행될 것이다.

*Spring Boot는 기본적으로 8080 포트를 사용

 

 

 

만약 8080 포트로 서버가 실행되지 않는다면,

 

 

 

1️⃣ build.gragle 의존성 추가

프로젝트 생성시 Spring Boot Web 의존성을 추가하지 않았다면 build.gragle에 의존성을 추가한다.

implementation 'org.springframework.boot:spring-boot-starter-web'

 

 

 

의존성을 추가한 후 다시 시도해보면 이번엔 에러 메시지가 뜬다.

Spring Boot 애플리케이션 실행 중 Java 프로세스가 비정상 종료되었음을 의미한다.

다양한 원인이 있겠지만 필자는 포트 충돌로 인한 에러임을 확인했다.

Execution failed for task ':CroomApplication.main()'.
> Process 'command '/Library/Java/JavaVirtualMachines/jdk-21.0.1.jdk/Contents/Home/bin/java'' finished with non-zero exit value 1

 

 

2️⃣ 포트번호 변경

8080 포트가 이미 다른 애플리케이션에서 사용중이라 충돌이 발생했다.

 

특정 포트를 사용하는 프로세스 확인

lsof -i :<포트번호>

 

 

 

이 때 PID를 확인한 후 해당 프로세스를 종료하고 싶다면 아래 명령어를 입력한다.

kill -9 <PID>

 

 

 

8080 포트를 사용중인 프로세스를 종료하지 않고 포트번호를 변경하려면 application.properties 파일에 내용을 추가한다.

server.port=8000

 

 

 

3. 브라우저 확인

서버가 성공적으로 실행되었다.

 

 

브라우저에서 http://localhost:8000으로 접속하면 애플리케이션을 확인할 수 있다.

 

 

 

 

 

참고

https://wikidocs.net/160047

https://velog.io/@leesomyoung/Maven%EA%B3%BC-Gradle%EC%9D%98-%EC%B0%A8%EC%9D%B4-%EB%B0%8F-%EB%B9%84%EA%B5%90

https://velog.io/@alsduq1117/Spring-Initializar