maven自动部署到远程tomcat服务器的方法
发布时间 - 2026-01-11 03:05:15 点击率：次使用maven的自动部署功能可以很方便的将maven工程自动部署到远程tomcat服务器，节省了大量时间。
本文章适用于tomcat的7.x ,8.x, 9.x版本。
下面是自动部的步骤
1，首先，配置tomcat的manager
编辑远程tomcat服务器下的conf/tomcat-users.xml,在末尾增加（其实只要拉到文件末尾，去掉注释改一下就可以了）
<role rolename="manager-gui"/> <role rolename="manager-script"/> <user username="admin" password="password" roles="manager-script"/> <user username="root" password="password" roles="manager-gui"/>
将上面的password改为自己的密码，注意对于tomcat9来说，不能同时赋予用户manager-script和manager-gui角色。
保存tomcat-users.xml。
在tomcat服务器的conf/Catalina/localhost/目录下创建一个manager.xml文件，写入如下值:
<?xml version="1.0" encoding="UTF-8"?>
<Context privileged="true" antiResourceLocking="false"
docBase="${catalina.home}/webapps/manager">
<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="^.*$" />
</Context>
保存退出。
然后在浏览器中输入http://serverip:port/manager/html，此时会弹出要求输入用户名和密码对话框，输入manager-gui对应的用户和密码登录管理控制台(其中serverip为服务器ip，如果服务器在本地就是localhost或者127.0.0.1，端口为tomcat端口，默认8080)。以此确认manager是否配置正确。正确结果示例如下：
2，在maven项目中添加配置
在pom.xml文件中，在plugins节点下添加如下plugin节点
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<configuration>
<url>http://serverip:port/manager/text</url>
<username>admin</username>
<password>password</password>
<update>true</update>
<path>/webapp</path>
</configuration>
</plugin>
将上面的serverip和port换成自己tomcat服务器的ip和端口。密码换成上面配置的manager-script角色的密码。path改为项目在tomcat服务器中的部署路径。
然后进行部署，如果是第一次部署，运行mvn tomcat7:deploy进行自动部署(对于tomcat8,9，也是使用tomcat7命令)，如果是更新了代码后重新部署更新，运行mvn tomcat7:redeploy，如果第一次部署使用mvn tomcat7:redeploy，则只会执行上传war文件，服务器不会自动解压部署。如果路径在tomcat服务器中已存在并且使用mvn tomcat7:deploy命令的话，上面的配置中一定要配置<update>true</update>，不然会报错。
如果IDE是eclipse,就在runas->run configurations中配置一个maven build，intellij类似。
3. 内存泄漏
使用上面的方法进行部署后会出现严重的内存泄漏现象。tomcat的manager提供了诊断在部署时是否产生内存泄漏的功能，在上面提到的http://serverip:port/manager/html这个页面底部有一个“Find leaks”的按钮，如下：
点击按钮，网页头部出现如下信息说明在部署的时候有内存泄漏：
上面的消息显示部署的test项目存在内存泄漏，如果同一项目多次重新部署，则一个项目名可能会出现多次。
部署时产生内存泄漏的原因是每次（重新）部署时，Tomcat会为项目新建一个类加载器，而旧的类加载器没有被GC回收。maven的库classloader-leak-prevention-servlet可以用来解决这个问题。具体方案为：
（1）添加maven依赖：
<dependency> <groupId>se.jiderhamn.classloader-leak-prevention</groupId> <artifactId>classloader-leak-prevention-servlet</artifactId> <version>2.1.0</version> </dependency>
（2）在项目的web.xml中添加一个Listener（必须让此Listener成为web.xml中的第一个Listener，否则不起作用）
<listener> <listener-class>se.jiderhamn.classloader.leak.prevention.ClassLoaderLeakPreventorListener</listener-class> </listener>
这样部署时的内存泄漏就解决了。
注意：
1） 添加这个Listener后，默认在tomcat关闭5s后jvm会进行内存回收的操作，具体时间设置可在下面的第三个参考链接中找到，所以，在关闭后的5s内，再次启动tomcat，可能会存在问题，导致启动无效（如果出现tomcat重启后日志显示正常但是服务器不工作的话考虑一下是不是这个问题）。
2）这个Listener只解决部署的内存泄漏，其他问题（如jdbc等）产生的内存泄漏还需要自己解决。
参考：
http://stackoverflow.com/questions/7788280/memory-leak-when-redeploying-application-in-tomcat#answer-36295683
http://java.jiderhamn.se/2011/12/11/classloader-leaks-i-how-to-find-classloader-leaks-with-eclipse-memory-analyser-mat/
https://github.com/mjiderhamn/classloader-leak-prevention
4，错误排除。
(1) 执行tomcat7:deploy显示Build Success成功但是没有效果，也没有在本地生成war包，检查一下maven配置文件中packaging标签是否设置为war。即：
<packaging>war</packaging>
如果不是（比如说是pom），那么改成war应该就可以了。
(2) 如果出现在本地tomcat服务器自动部署没有任何问题，部署到远程服务器出现下面的Cannot invoke Tomcat manager: Connection reset by peer: socket write error 错误：
[ERROR] Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin:2.2:deploy (default-cli) on project webapp: Cannot invoke Tomcat manager: Connection reset by peer: socket write error -> [Help 1] org.apache.maven.lifecycle.LifecycleExecutionException: Failed to execute goal org.apache.tomcat.maven:tomcat7-maven-plugin:2.2:deploy (default-cli) on project clyf_wechat: Cannot invoke Tomcat manager at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:212) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:153) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:145) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:116) at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:80) at org.apache.maven.lifecycle.internal.builder.singlethreaded.SingleThreadedBuilder.build(SingleThreadedBuilder.java:51) at org.apache.maven.lifecycle.internal.LifecycleStarter.execute(LifecycleStarter.java:128) at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:307) at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:193) at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:106) at org.apache.maven.cli.MavenCli.execute(MavenCli.java:863) at org.apache.maven.cli.MavenCli.doMain(MavenCli.java:288) at org.apache.maven.cli.MavenCli.main(MavenCli.java:199) at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) at java.lang.reflect.Method.invoke(Method.java:497) at org.codehaus.plexus.classworlds.launcher.Launcher.launchEnhanced(Launcher.java:289) at org.codehaus.plexus.classworlds.launcher.Launcher.launch(Launcher.java:229) at org.codehaus.plexus.classworlds.launcher.Launcher.mainWithExitCode(Launcher.java:415) at org.codehaus.plexus.classworlds.launcher.Launcher.main(Launcher.java:356) Caused by: org.apache.maven.plugin.MojoExecutionException: Cannot invoke Tomcat manager at org.apache.tomcat.maven.plugin.tomcat7.AbstractCatalinaMojo.execute(AbstractCatalinaMojo.java:141) at org.apache.tomcat.maven.plugin.tomcat7.AbstractWarCatalinaMojo.execute(AbstractWarCatalinaMojo.java:68) at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:134) at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:207) ... 20 more Caused by: java.net.SocketException: Connection reset by peer: socket write error at java.net.SocketOutputStream.socketWrite0(Native Method) at java.net.SocketOutputStream.socketWrite(SocketOutputStream.java:109) at java.net.SocketOutputStream.write(SocketOutputStream.java:153) at org.apache.http.impl.io.AbstractSessionOutputBuffer.write(AbstractSessionOutputBuffer.java:181) at org.apache.http.impl.io.ContentLengthOutputStream.write(ContentLengthOutputStream.java:115) at org.apache.tomcat.maven.common.deployer.TomcatManager$RequestEntityImplementation.writeTo(TomcatManager.java:880) at org.apache.http.entity.HttpEntityWrapper.writeTo(HttpEntityWrapper.java:89) at org.apache.http.impl.client.EntityEnclosingRequestWrapper$EntityWrapper.writeTo(EntityEnclosingRequestWrapper.java:108) at org.apache.http.impl.entity.EntitySerializer.serialize(EntitySerializer.java:117) at org.apache.http.impl.AbstractHttpClientConnection.sendRequestEntity(AbstractHttpClientConnection.java:265) at org.apache.http.impl.conn.ManagedClientConnectionImpl.sendRequestEntity(ManagedClientConnectionImpl.java:203) at org.apache.http.protocol.HttpRequestExecutor.doSendRequest(HttpRequestExecutor.java:236) at org.apache.http.protocol.HttpRequestExecutor.execute(HttpRequestExecutor.java:121) at org.apache.http.impl.client.DefaultRequestDirector.tryExecute(DefaultRequestDirector.java:682) at org.apache.http.impl.client.DefaultRequestDirector.execute(DefaultRequestDirector.java:486) at org.apache.http.impl.client.AbstractHttpClient.doExecute(AbstractHttpClient.java:863) at org.apache.http.impl.client.CloseableHttpClient.execute(CloseableHttpClient.java:82) at org.apache.tomcat.maven.common.deployer.TomcatManager.invoke(TomcatManager.java:742) at org.apache.tomcat.maven.common.deployer.TomcatManager.deployImpl(TomcatManager.java:705) at org.apache.tomcat.maven.common.deployer.TomcatManager.deploy(TomcatManager.java:388) at org.apache.tomcat.maven.plugin.tomcat7.deploy.AbstractDeployWarMojo.deployWar(AbstractDeployWarMojo.java:85) at org.apache.tomcat.maven.plugin.tomcat7.deploy.AbstractDeployMojo.invokeManager(AbstractDeployMojo.java:82) at org.apache.tomcat.maven.plugin.tomcat7.AbstractCatalinaMojo.execute(AbstractCatalinaMojo.java:132) ... 23 more
使用mvn tomcat7:redeploy时出现如下情况
经过查询Tomcat文档后发现，这是由于Tomcat的远程地址拦截器造成的结果，默认情况下，Tomcat的Manager和Host-Manager只接受本机的请求，而要让它接受远程的请求，需要添加上面提到的manager.xml的配置（第一步配置过了就不要加了），也就是：
<?xml version="1.0" encoding="UTF-8"?>
<Context privileged="true" antiResourceLocking="false"
docBase="${catalina.home}/webapps/manager">
<Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="^.*$" />
</Context>
由于Tomcat的Manager可以执行项目的部署、卸载等敏感操作，如果你只想允许特定的IP地址访问Manager，可在上面的allow属性中设置规则。具体规则设置见下面的链接：
http://tomcat.apache.org/tomcat-7.0-doc/config/valve.html#Remote_Address_Filter
问题说明：http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html#Configuring_Manager_Application_Access
(3)自动部署显示成功，war包也上传成功，但是war不自动解压自动部署。
如果你在tomcat的server.xml中通过设置<Context>标签来部署相同名称的项目的话，maven发布到该服务器的war不会被自动解压，部署，更新，需要去掉server.xml中该项目的<Context>标签。
5. 其他
如果想要实现对部署路径加版本，可将上面tomcat7-maven-pluginconfiguration的path设置为
<path>/webapp#version</path>
的形式，部署后，当前项目在服务器端的路径就是/webapp/version。举个例子，如果path设置为 test#1.0，那么服务端项目实际的路径就是/test/1.0。如下：
如果名字和版本号之间是两个#，效果就是制定当前项目在manager网页中显示的版本，路径不变，举个例子，path设置为test##1.0，实际部署路径为/test，但是在manager网页中，显示如下，注意Version一栏的值：
参考：
http://tomcat.apache.org/tomcat-7.0-doc/config/context.html#Naming
# maven自动部署
# 远程tomcat
# Idea配置maven-tomcat-plugin插件实现项目部署
# maven tomcat plugin实现热部署
# IntelliJ IDEA使用maven实现tomcat的热部署
# Maven项目打包成war包部署到Tomcat的方法
# maven如何在tomcat8中实现自动部署
# Maven+Tomcat8 实现自动化部署的方法
# Maven添加Tomcat插件实现热部署代码实例
# 设置为
# 可在
# 器中
# 就可以
# 举个例子
# 自己的
# 这是
# 加载
# 上传
# 如果你
# 就在
# 过了
# 第一个
# 没有任何
# 出现在
# 你在
# 适用于
# 这个问题
# 只会
# 弹出
相关栏目：
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐：
如何快速打造个性化非模板自助建站？
C#如何调用原生C++ COM对象详解
如何用JavaScript实现文本编辑器_光标和选区怎么处理
在centOS 7安装mysql 5.7的详细教程
Laravel如何使用Telescope进行调试？（安装和使用教程）
详解Android中Activity的四大启动模式实验简述
Laravel队列由Redis驱动怎么配置_Laravel Redis队列使用教程
Laravel如何创建和注册中间件_Laravel中间件编写与应用流程
如何用AI一键生成爆款短视频文案？小红书AI文案写作指令【教程】
北京网站制作公司哪家好一点,北京租房网站有哪些？
非常酷的网站设计制作软件,酷培ai教育官方网站？
如何在七牛云存储上搭建网站并设置自定义域名？
canvas 画布在主流浏览器中的尺寸限制详细介绍
Gemini手机端怎么发图片_Gemini手机端发图方法【步骤】
Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】
Laravel事件监听器怎么写_Laravel Event和Listener使用教程
java获取注册ip实例
简单实现Android验证码
大学网站设计制作软件有哪些,如何将网站制作成自己app？
,交易猫的商品怎么发布到网站上去？
Laravel怎么使用artisan命令缓存配置和视图
北京网站制作的公司有哪些,北京白云观官方网站？
Laravel如何编写单元测试和功能测试？（PHPUnit示例）
html5如何实现懒加载图片_ intersectionobserver api用法【教程】
详解Android图表 MPAndroidChart折线图
js实现点击每个li节点，都弹出其文本值及修改
Win11怎么修改DNS服务器 Win11设置DNS加速网络【指南】
phpredis提高消息队列的实时性方法(推荐)
Win11摄像头无法使用怎么办_Win11相机隐私权限开启教程【详解】
HTML5空格在Angular项目里怎么处理_Angular中空格的渲染问题【详解】
Laravel如何与Pusher实现实时通信？（WebSocket示例）
韩国代理服务器如何选？解析IP设置技巧与跨境访问优化指南
js代码实现下拉菜单【推荐】
如何快速生成高效建站系统源代码？
Laravel如何使用Contracts（契约）进行编程_Laravel契约接口与依赖反转
PHP的CURL方法curl_setopt()函数案例介绍(抓取网页,POST数据)
详解免费开源的.NET多类型文件解压缩组件SharpZipLib（.NET组件介绍之七）
如何正确选择百度移动适配建站域名？
Laravel怎么使用Intervention Image库处理图片上传和缩放
高防网站服务器：DDoS防御与BGP线路的AI智能防护方案
Laravel如何升级到最新版本？（升级指南和步骤）
Laravel怎么定时执行任务_Laravel任务调度器Schedule配置与Cron设置【教程】
Laravel怎么写单元测试_PHPUnit在Laravel项目中的基础测试入门
Laravel怎么使用Markdown渲染文档_Laravel将Markdown内容转HTML页面展示【实战】
Laravel如何优雅地处理服务层_在Laravel中使用Service层和Repository层
如何用手机制作网站和网页,手机移动端的网站能制作成中英双语的吗？
如何构建满足综合性能需求的优质建站方案？
Android自定义控件实现温度旋转按钮效果
Laravel如何使用Service Provider服务提供者_Laravel依赖注入与容器绑定【深度】
Laravel怎么生成URL_Laravel路由命名与URL生成函数详解