Spring Boot 프로젝트를 빌드하고 실행하는 방법 (Maven 활용)

Spring Boot 프로젝트를 빌드하고 실행하는 방법 (Maven 활용)

Spring Boot는 Maven을 사용하여 프로젝트를 빌드하고 실행하는 것을 매우 간단하게 만들어 줍니다. 이 글에서는 Maven을 활용하여 Spring Boot 애플리케이션을 빌드하고 실행하는 방법을 단계별로 설명합니다.

---

1. Maven 기본 설정 확인

Spring Boot 프로젝트의 pom.xml 파일에 Maven 관련 설정이 올바르게 되어 있는지 확인합니다. Spring Boot 프로젝트를 생성할 때 기본적으로 Maven 관련 설정이 포함되어 있습니다.

기본 pom.xml 예제:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>spring-boot-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.4</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

---

2. 프로젝트 빌드

Maven을 사용하여 Spring Boot 프로젝트를 빌드하면 .jar 파일이 생성됩니다. 생성된 .jar 파일은 실행 가능한 상태가 됩니다.

빌드 명령:

mvn clean package

설명:

• mvn clean: 이전 빌드 결과물을 삭제합니다.
• mvn package: 프로젝트를 빌드하고 실행 가능한 .jar 파일을 생성합니다.

결과:

• target 디렉토리에 실행 가능한 .jar 파일이 생성됩니다.
  • 예: target/spring-boot-demo-0.0.1-SNAPSHOT.jar

---

3. 애플리케이션 실행

1. Maven 명령으로 실행:

mvn spring-boot:run

설명:

• spring-boot:run은 Maven 플러그인을 사용하여 애플리케이션을 실행합니다. 개발 중에 빠르게 테스트할 때 유용합니다.

2. 빌드된 .jar 파일로 실행:

java -jar target/spring-boot-demo-0.0.1-SNAPSHOT.jar

설명:

• 빌드된 .jar 파일을 Java 명령으로 실행합니다.
• 이 방법은 프로덕션 환경에서 애플리케이션을 배포할 때 사용됩니다.

---

4. 추가 Maven 명령어

1. 종속성 다운로드:

mvn dependency:resolve

• 프로젝트에서 필요한 모든 의존성을 다운로드합니다.

2. 테스트 실행:

mvn test

• 프로젝트의 모든 테스트 코드를 실행합니다.

3. 클린 빌드:

mvn clean install

• 프로젝트를 깨끗이 빌드하고 Maven 로컬 저장소에 아티팩트를 설치합니다.

---

5. Spring Boot Maven 플러그인 옵션

spring-boot-maven-plugin은 Spring Boot 프로젝트에 기본적으로 포함되어 있으며, 다양한 옵션을 제공합니다.

1. 재실행 모드 (DevTools 활성화):

mvn spring-boot:run -Dspring-boot.run.fork=false

• 코드를 수정할 때 애플리케이션을 자동으로 재시작합니다.

2. 특정 프로파일 실행:

mvn spring-boot:run -Dspring-boot.run.profiles=dev

• 특정 Spring 프로파일을 활성화하여 애플리케이션을 실행합니다.

---

6. 문제 해결

1. 빌드 오류 발생 시:

   • pom.xml 파일에서 의존성 버전을 확인하세요.
   • mvn dependency:tree 명령으로 의존성 충돌 여부를 점검하세요.

2. 포트 충돌:

   • 애플리케이션이 실행되지 않고 포트 충돌 오류가 발생하면, application.properties 또는 application.yml 파일에서 포트를 변경하세요:

     server.port=8081

---