Error assembling WAR: webxml attribute is required (or pre-existing WEB-INF/web.xml if executing in update mode)

지난 글에서,

IntelliJ + Spring Framework 프로젝트 생성
; https://www.sysnet.pe.kr/2/0/12757

pom.xml에 war 패키징 옵션만 넣고,

<packaging>war</packaging>

maven package 명령을 실행했더니 다음과 같은 오류가 발생합니다.



검색 결과 다음과 같은 글이 있습니다.

[Maven] package 할 시 발생하는 'webxml attribute is required' 에러
; http://1004lucifer.blogspot.com/2017/06/maven-package-webxml-attribute-is.html

위의 지시에 따라 "<failOnMissingWebXml>false</failOnMissingWebXml>" 설정을 추가하면 실제로 에러가 발생하지 않습니다.

// pom.xml

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <configuration>
                <failOnMissingWebXml>false</failOnMissingWebXml>
            </configuration>
        </plugin>
    </plugins>
</build>

그런데, 좀 이해가 안 되는 것이 있다면 분명히 현재 프로젝트에는 /web/WEB-INF/web.xml 파일이 있습니다. 하지만 위의 오류 메시지에서는 그걸 찾지 못해 발생하는 듯한데요, 좀 더 검색을 해보니 더 나은 해결책이 나옵니다.

"webxml attribute is required" error in Maven
; https://stackoverflow.com/questions/5351948/webxml-attribute-is-required-error-in-maven

그래서 다음과 같이 webXml 노드를 추가하면 해결이 됩니다.

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <configuration>
                <webXml>web\WEB-INF\web.xml</webXml>
            </configuration>
        </plugin>
    </plugins>
</build>

어쨌든 war 파일이 생성되긴 했는데, 크기가 3KB라는 것이 좀 걸리는군요. ^^;

---

일단 war 문제는 해결했는데, 여전히 IntelliJ의 빌드 로그를 보면 이런 경고가 나옵니다.

"C:\Program Files\Java\jdk1.8.0_161\bin\java.exe" -Dmaven.multiModuleProjectDirectory=D:\intellij\spring-sample-01 "-Dmaven.home=C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3" "-Dclassworlds.conf=C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3\bin\m2.conf" "-Dmaven.ext.class.path=C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven-event-listener.jar" "-javaagent:C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\lib\idea_rt.jar=30250:C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\bin" -Dfile.encoding=UTF-8 -classpath "C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3\boot\plexus-classworlds-2.6.0.jar;C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3\boot\plexus-classworlds.license" org.codehaus.classworlds.Launcher -Didea.version=2021.1.3 package
[INFO] Scanning for projects...
[WARNING] 
[WARNING] Some problems were encountered while building the effective model for org.example:spring-sample-01:war:1.0-SNAPSHOT
[WARNING] 'build.plugins.plugin.version' for org.apache.maven.plugins:maven-war-plugin is missing. @ line 23, column 21
[WARNING] 
[WARNING] It is highly recommended to fix these problems because they threaten the stability of your build.
[WARNING] 
[WARNING] For this reason, future Maven versions might no longer support building such malformed projects.
...[생략]...

검색해 보면,

Maven 3 warnings about build.plugins.plugin.version
; https://stackoverflow.com/questions/4123044/maven-3-warnings-about-build-plugins-plugin-version

version을 기입하면 된다고 합니다. 또한, 그 버전을 구하는 방법까지 소개하고 있는데요, 이를 위해 IntelliJ에서 빌드 시 사용하는 maven 경로를 알아야 했는데 위의 빌드 로그에 다음과 같은 경로를 통해 알 수 있습니다.

"-Dmaven.home=C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3"

따라서 이렇게 실행해 주면,



다음의 출력을 얻어,

Name: Apache Maven WAR Plugin
Description: Builds a Web Application Archive (WAR) file from the project
  output and its dependencies.
Group Id: org.apache.maven.plugins
Artifact Id: maven-war-plugin
Version: 3.2.2
Goal Prefix: war

이렇게 마무리할 수 있습니다.

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.2.2</version>
            <configuration>
                <webXml>web\WEB-INF\web.xml</webXml>
            </configuration>
        </plugin>
    </plugins>
</build>

---

휴~~~ 마지막 빌드 경고입니다.

...[생략]...
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ spring-sample-01 ---
[WARNING] Using platform encoding (UTF-8 actually) to copy filtered resources, i.e. build is platform dependent!
...[생략]...
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ spring-sample-01 ---
[WARNING] Using platform encoding (UTF-8 actually) to copy filtered resources, i.e. build is platform dependent!
...[생략]...

검색 결과, project.build.sourceEncoding 값을 pom.xml에 추가하면 해결됩니다.

<properties>
    <maven.compiler.source>8</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

이제야 maven install 단계까지 아무런 경고 없이 실행이 됩니다.

"C:\Program Files\Java\jdk1.8.0_161\bin\java.exe" -Dmaven.multiModuleProjectDirectory=D:\intellij\spring-sample-01 "-Dmaven.home=C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3" "-Dclassworlds.conf=C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3\bin\m2.conf" "-Dmaven.ext.class.path=C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven-event-listener.jar" "-javaagent:C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\lib\idea_rt.jar=1034:C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\bin" -Dfile.encoding=UTF-8 -classpath "C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3\boot\plexus-classworlds-2.6.0.jar;C:\Program Files\JetBrains\IntelliJ IDEA 2021.1.2\plugins\maven\lib\maven3\boot\plexus-classworlds.license" org.codehaus.classworlds.Launcher -Didea.version=2021.1.3 install
[INFO] Scanning for projects...
[INFO] 
[INFO] --------------------< org.example:spring-sample-01 >--------------------
[INFO] Building Spring Framework 1.0-SNAPSHOT
[INFO] --------------------------------[ war ]---------------------------------
[INFO] 
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ spring-sample-01 ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] Copying 0 resource
[INFO] 
[INFO] --- maven-compiler-plugin:3.1:compile (default-compile) @ spring-sample-01 ---
[INFO] Nothing to compile - all classes are up to date
[INFO] 
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ spring-sample-01 ---
[INFO] Using 'UTF-8' encoding to copy filtered resources.
[INFO] skip non existing resourceDirectory D:\intellij\spring-sample-01\src\test\resources
[INFO] 
[INFO] --- maven-compiler-plugin:3.1:testCompile (default-testCompile) @ spring-sample-01 ---
[INFO] Nothing to compile - all classes are up to date
[INFO] 
[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ spring-sample-01 ---
[INFO] No tests to run.
[INFO] 
[INFO] --- maven-war-plugin:3.2.2:war (default-war) @ spring-sample-01 ---
[INFO] Packaging webapp
[INFO] Assembling webapp [spring-sample-01] in [D:\intellij\spring-sample-01\target\spring-sample-01-1.0-SNAPSHOT]
[INFO] Processing war project
[INFO] Webapp assembled in [14 msecs]
[INFO] Building war: D:\intellij\spring-sample-01\target\spring-sample-01-1.0-SNAPSHOT.war
[INFO] 
[INFO] --- maven-install-plugin:2.4:install (default-install) @ spring-sample-01 ---
[INFO] Installing D:\intellij\spring-sample-01\target\spring-sample-01-1.0-SNAPSHOT.war to %USERPROFILE%\.m2\repository\org\example\spring-sample-01\1.0-SNAPSHOT\spring-sample-01-1.0-SNAPSHOT.war
[INFO] Installing D:\intellij\spring-sample-01\pom.xml to %USERPROFILE%\.m2\repository\org\example\spring-sample-01\1.0-SNAPSHOT\spring-sample-01-1.0-SNAPSHOT.pom
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  2.875 s
[INFO] Finished at: 2021-08-07T22:49:15+09:00
[INFO] ------------------------------------------------------------------------

Process finished with exit code 0

---

[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[최초 등록일: 8/7/2021]
[최종 수정일: 8/8/2021]


이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

by SeongTae Jeong, mailto:techsharer at outlook.com