[Maven] pom.xml에 설정한 plugin이 실행되지 않는 문제

✅ 오류

pom.xml 파일에 Maven plugin 중

`maven-dependency-plugin` 과 `maven-jar-plugin` 을 설정해주었는데,

플러그인이 실행되지 않는 이슈가 있었다.

 

분명히 <project><build>하위의 <plugins> 태그에

각각의 플러그인 설정을 해주었기 때문에

 

jar 파일로 패키징이 완료된 시점에서는 `target/` 하위에 `libs`라는 패키지가 생기고,

그 디렉토리에는 추가한 외부 라이브러리들이 jar 형태로 들어가 있어야 했다.

 

하지만 target/libs 디렉토리 자체가 생성되지 않는 문제가 있었다.

---

 

설정대로 제대로 동작했다면, mvn clean package 명령어를 실행했을 때 로그에도 분명히

 

이런 식으로 target/libs 하위에 jar파일을 copy하는 중이라는 로그가 찍혀야 하는데

설정해준 copy-dependencies 와 관련된 로그가 전혀 찍히지 않았다.

 

그래서 생성된 jar 파일을 실행하면 NoClassDefFoundError가 발생했다.

너무나도 당연하게 외부 라이브러리를 읽을 수 없었기 때문에 발생한 에러이다.

 

✅ 원인과 해결

문제의 원인은 pom.xml에서 플러그인 설정을 잘못 해주었기 때문이다.

 

내가 작성한 pom.xml 파일을 자세히 들여다보니

plugin 설정이 <project><build><plugins> 하위에 있지 않는 것이 아니라,

<project><build><pluginManagement><plugins> 하위에 있었다.

 

---

 

그렇다면 <pluginManagement> 태그는 도대체 뭘까?

 

<pluginManagement> 태그는 부모 프로젝트에서 자식 프로젝트로 플러그인 버전 관리 및 기본 설정을 전달하는 용도로 사용되며,

<pluginManagement> 태그 안에 있는 플러그인은 자식 프로젝트에서 따로 정의되지 않으면 실행되지 않는다고 한다.

 

즉 <pluginMangement> 태그 안에 설정한 플러그인들은 실행이 되지 않을 수 있다는 것이다!

 

---

그래서 모든 plugin 설정을 <project><build><plugins>로 옮겨주었다. .

 

mvn package 명령어로 jar 파일을 다시 생성하자, 내가 설정한대로 target/libs 디렉토리가 생성되어 하위에 외부 라이브러리 jar 파일들이 복사되어 들어갔다.

물론 프로그램도 정상적으로 실행되었다.

 

✅ 추가 고찰

해당 프로젝트를 생성할 때 maven-archetype-quickstart로 생성했었다.

 

프로젝트 빌드할 때부터 pom.xml에

<build><pluginManagement> 태그와 하위 플러그인 설정들이 생겼고

<pluginManagement> 태그에는 아래와 같은 주석이 적혀있었다.

Lock down plugins versions to avoid using Maven defaults (may be moved to parent pom)

 

문제를 해결하기 전에는 주석 내용이 이해도 안 되고 중요하다고 생각되지 않아서 그냥 넘어갔었다.

 

다시 보니, 자동으로 maven 프로젝트가 생성될 때 parent 프로젝트의 디폴트 플러그인 설정들이 함께 생성된 것이고,

"이러한 설정들 때문에 현재 프로젝트가 의도대로 동작하지 않을 수 있으니 이러한 설정은 parent 프로젝트의 pom.xml로 이동하는 것이 좋다" 정도로 해석하면 괜찮을 것 같다고 생각했다.