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>