maven tomcat plugin实现热部署

1、Tomcat7的用户及权限配置

要实现热部署，自然就需要通过maven操作tomcat，所以就需要maven取得操作tomcat的权限，现在这一步就是配置tomcat的可操作权限。

在tomcat的安装目录下,修改conf / tomcat-user.xml文件,在<tomcat-users>节点下面增加如下配置:

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

2、Maven的server的配置

在Maven的安装路径找到,修改D:\develop_tools\maven\apache-maven-3.3.9\conf \setting.xml文件 ,在<server>节点中添加tomcat7下配置的用户信息（id可以任意填写，但username和password必须和步骤1一致）

<server>        <id>tomcat7</id>        <username>tomcat</username>        <password>tomcat</password>    </server>  

3、Web项目pom.xml的配置

3.1、apache官方tomcat插件的配置

tomcat7的配置：

<plugins>       <!-- 第一种方式: apache官方tomcat插件,支持deploy -->       <plugin>           <groupId>org.apache.tomcat.maven</groupId>           <artifactId>tomcat7-maven-plugin</artifactId>           <version>2.0-SNAPSHOT</version>           <configuration>               <url>http://localhost:8080/manager/text</url>               <server>tomcat7</server>           </configuration>       </plugin>    </plugins> 

3.2 第三方tomcat插件,支持redeploy

tomcat7的配置：

<plugin>      <groupId>org.codehaus.mojo</groupId>      <artifactId>tomcat-maven-plugin</artifactId>      <version>1.1</version>      <configuration>          <url>http://localhost:8080/manager/text</url>          <server>tomcat7</server>          <ignorePackaging>true</ignorePackaging>      </configuration>  </plugin>  

3.3 maven仓库的配置 （此为可选项）：

<repository>      <id>people.apache.snapshots</id>      <url>http://repository.apache.org/content/groups/snapshots-group/</url>      <releases>          <enabled>false</enabled>      </releases>      <snapshots>          <enabled>true</enabled>      </snapshots>  </repository>  <pluginRepository>      <id>apache.snapshots</id>      <name>Apache Snapshots</name>      <url>http://repository.apache.org/content/groups/snapshots-group/</url>      <releases>          <enabled>false</enabled>      </releases>      <snapshots>          <enabled>true</enabled>      </snapshots>  </pluginRepository>  

4、设置部署命令

一般使用搜是在eclipse中,可以右键点击需要部署的项目,Run as -> Run configurations -> maven build -> 右键 new,这样配置一个新的maven命令
具体配置命令方法:
1.在base directory中选择自己的项目
2.Goals的配置
如果使用apache的官方插件,那么就用 “tomcat7:deploy” 命令
如果使用第三方插件,那么就用 “tomcat:redeploy”命令

5、附相关错误及解决办法:

• 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

• undeploy 失败
  在Window系统下执行在执行 mvn tomcat7:undeploy时，会有残留在tomcat目录下
  解决方法：在tomcat的配置文件context.xml中 的< Context >标签中添加属性：antiJARLocking=”true” antiResourceLocking=”true”
  即

<Context antiJARLocking="true" antiResourceLocking="true">

• 401错误
  报错信息如下:
  

[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: 401 for URL: http://localhost:8080/manager/text/deploy?path=%2Fhelloworld -> [Help 1]
原因：权限问题
解决办法在$CATALINA_BASE/conf/tomcat-users.xml，
如D:\apache-tomcat-7.0.34\conf\tomcat-users.xml文件中添加权限

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

修改pom.xml文件，在<configuration> </configuration>中添加

<username>admin</username><password>admin</password>

• 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="admin" roles="manager-gui, manager-script"/></tomcat-users>