Maven自动部署war到Tomcat8

原文：http://www.cnblogs.com/yucongblog/p/5392932.html

我使用的环境是：Eclipse Java EE IDE for Web Developers（Version: Luna Service Release 2 (4.4.2)）

apache-tomcat-8.0.32

apache-maven-3.3.9

实战过程如下：

第一步：配置Tomcat访问权限

要打开tomcat的manager功能；

在conf文件夹下的tomcat-users.xml的<tomcat-users>标签内添加如下内容

<role rolename="manager-gui"/>
  <role rolename="manager-script"/>
  <role rolename="manager-jmx"/>
  <role rolename="manager-status"/>
  <user password="123456" username="admin"
 roles="manager-gui,manager-script,manager-jmx,manager-status" />

<role rolename="manager-gui"/>
  <role rolename="manager-script"/>
  <role rolename="manager-jmx"/>
  <role rolename="manager-status"/>
  <user password="123456" username="admin"
 roles="manager-gui,manager-script,manager-jmx,manager-status" />

启动tomcat并访问http://localhost:8080/manager

输入配置的用户名(admin)和密码(123456)看是否可以登录，如果可以进下一步

第二步：配置maven的setting.xml

在conf/setting.xml文件中的标签<servers>添加子标签

 <server>
     <id>tomcat8</id>
     <username>admin</username>
     <password>123456</password>
 </server>

注意，这里配置的username和password一定要和tomcat中的tomcat_user.xml中一致。

第三步：配置pom.xml

在pom.xml中添加如下代码,在标签<project>下添加子标签

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-compiler-plugin</artifactId>
      <configuration>
        <source>1.8</source>
        <target>1.8</target>
      </configuration>
    </plugin>

    <plugin>
      <groupId>org.apache.tomcat.maven</groupId>
      <artifactId>tomcat7-maven-plugin</artifactId>
      <version>2.2</version>
      <configuration>
           <!-- 远程tomcat下manager路径 -->
        <url>http://localhost:8080/manager/text</url>
        <server>tomcat8</server>
      </configuration>
    </plugin>

  </plugins>
</build>

以上几步完成以后就可以执行mvn命令了，如下操作：

(1) mvn clean install

(2) mvn tomcat7:deploy (第一次部署执行)

(3) mvn tomcat7:redeploy（第二次部署是执行）

注意：第一次发布是执行（2），已经发布了，需要重新发布执行（3）。

通过以上操作就可以通过maven把项目自动部署到tomcat了。

在Maven与Tomcat配合部署过程中，最常见的错误有三种，以及相应的完美解决办法

1.  Connection refused错误

报错信息如下：

[ERROR]Failed to execute goal org.apache.tomcat.maven: tomcat7-maven-plugin: 2.0- SNAPSHOT: deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Connection refused: connect -> [Help 1]

原因：未启动Tomcat服务器

解决办法：先启动Tomcat服务器再选择Run

2.  401错误

报错信息如下:

[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin: 2.2:deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Server returned HTTP response code: 401 for URL: http://localhost:8080/manager/text/deploy?path=%2Fhelloworld -> [Help 1]

原因：权限问题

解决办法在$CATALINA_BASE/conf/tomcat-users.xml，

如D:\apache-tomcat-8.0.20\conf\tomcat-users.xml文件中添加权限

<role rolename=”manager”/>
<user username=”admin” password=”123456” roles=”manager”/>

3. 403错误

报错信息如下：

[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin: 2.0-SNAPSHOT:deploy (default-cli) on project helloworld: Cannot invoke Tomcat manager: Server returned HTTP response code: 403 for URL: http://localhost:8080/manager/html/deploy?path=%2Fhelloworld -> [Help 1]

原因：产生该问题有可能因为两个原因，具体参见解决办法

解决办法：

1）如果使用的是Tomcat 7，需要修改pom.xml中部署的url地址，将<url>http://localhost:8080/manager</url>改<url>http://localhost:8080/manager/text</url>

2）给tomcat用户权限分配上，需要同时具备manager-gui和manager-script权限，我在遇到该问题时，就是忘了分配manager-script权限。

正确的conf/tomcat-users.xml配置应为：

<tomcat-users>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<user username="admin” password="123456" roles="manager-gui, manager-script"/>
</tomcat-users>