如何用 Apache Tomcat 部署 Java Web 应用？-Apache-PHP中文网

如何用 Apache Tomcat 部署 Java Web 应用？

煙雲

发布： 2025-06-22 09:06:02

原创

753人浏览过

部署java web应用到tomcat的方法包括：1. 准备war文件，使用maven或gradle生成；2. 将war文件复制到tomcat的webapps目录以自动部署；3. 通过tomcat manager app上传部署，需先在tomcat-users.xml中配置用户和角色；4. 使用context xml文件实现自动部署，于conf/catalina/localhost/下创建对应应用context path的xml文件；5. 启动tomcat后访问应用。常见错误如404 not found应检查context path、部署状态及防火墙设置；部署失败则查看日志并解决依赖冲突；session丢失可通过session持久化解决；内存溢出需优化代码并增加tomcat内存配置；中文乱码应在jsp、servlet及server.xml中设置utf-8编码。其他部署方式还包括使用jndi配置资源、maven tomcat插件集成构建流程或cargo框架管理容器。

如何用 Apache Tomcat 部署 Java Web 应用？

部署Java Web应用到Tomcat，其实就像把精心准备的菜肴端上餐桌。关键在于了解Tomcat的“餐桌礼仪”，也就是它的部署规则。

解决方案

准备你的WAR文件： WAR (Web Application Archive) 文件，是Java Web应用的打包格式。如果你的项目还没打包，使用Maven或Gradle等构建工具生成WAR文件。例如，在Maven项目中，运行 mvn clean package 命令会在 target 目录下生成你的WAR文件。

立即学习“Java免费学习笔记（深入）”；
找到Tomcat的webapps目录： 这是Tomcat默认的部署目录。通常位于Tomcat安装目录下的 webapps 文件夹中。
部署WAR文件： 有几种方法：
- 直接复制： 将你的WAR文件复制到 webapps 目录下。Tomcat会自动解压并部署你的应用。
- Tomcat Manager App： 通过Tomcat Manager App (默认URL通常是 http://localhost:8080/manager/html) 上传WAR文件进行部署。你需要配置Tomcat的用户和角色才能访问Manager App。
- 自动部署 (Context XML)： 在 conf/Catalina/localhost/ 目录下创建一个XML文件，文件名就是你的应用的Context Path。例如，如果你的应用叫 mywebapp.war，可以创建一个 mywebapp.xml 文件，内容如下：
```
<Context docBase="mywebapp" path="/mywebapp" reloadable="true" />
```
登录后复制
登录后复制
确保 docBase 指向你的WAR文件解压后的目录名（如果已经解压），或者WAR文件名（如果未解压）。path 属性定义了你的应用的Context Path，用户通过这个路径访问你的应用。 reloadable="true" 允许Tomcat在应用文件发生变化时自动重新加载应用，方便开发调试。
启动Tomcat： 如果Tomcat已经运行，它会自动部署你复制或上传的应用。如果没有运行，启动Tomcat。
访问你的应用： 在浏览器中输入 http://localhost:8080/mywebapp (假设你的Context Path是 /mywebapp)，就可以访问你的Java Web应用了。

如何配置Tomcat的用户和角色以便访问Manager App？

Tomcat的用户和角色配置主要在 tomcat-users.xml 文件中完成，该文件位于Tomcat安装目录的 conf 文件夹下。

打开 tomcat-users.xml 文件： 使用文本编辑器打开该文件。
添加用户和角色： 在标签内，添加和标签。例如：
```
<tomcat-users>
  <role rolename="manager-gui"/>
  <user username="admin" password="password" roles="manager-gui"/>
</tomcat-users>
```
登录后复制
- 标签定义了角色，rolename 属性指定角色名。manager-gui 角色允许用户访问Tomcat Manager App的GUI界面。
- 标签定义了用户，username 属性指定用户名，password 属性指定密码，roles 属性指定用户所属的角色，多个角色之间用逗号分隔。
你还可以添加其他角色，例如 manager-script (允许通过脚本访问Manager App)，admin-gui (允许访问Tomcat Admin App的GUI界面)，admin-script (允许通过脚本访问Admin App)。
保存文件并重启Tomcat： 保存 tomcat-users.xml 文件，然后重启Tomcat，使配置生效。
访问Manager App： 在浏览器中输入 http://localhost:8080/manager/html，使用你配置的用户名和密码登录。

注意： 在生产环境中，强烈建议使用更安全的密码，并限制对 tomcat-users.xml 文件的访问权限。

Tomcat部署WAR文件时常见的错误以及解决方法？

部署WAR文件到Tomcat时，可能会遇到各种问题。以下是一些常见的错误及其解决方法：

404 Not Found：
- 原因： Context Path配置错误、WAR文件未正确部署、Tomcat未启动、防火墙阻止访问等。
- 解决方法：
  - 检查Context Path是否正确，确保与WAR文件名或Context XML文件中的配置一致。
  - 检查WAR文件是否已正确复制到 webapps 目录，或者是否已通过Manager App成功上传。
  - 确保Tomcat已启动，并且没有出现启动错误。
  - 检查防火墙设置，确保允许访问Tomcat的端口 (默认为8080)。
部署失败，Tomcat日志出现异常：
- 原因： WAR文件损坏、依赖冲突、缺少必要的库文件、配置错误等。
- 解决方法：
  - 检查WAR文件是否完整，重新生成WAR文件。
  - 查看Tomcat的日志文件 (通常位于 logs 目录下)，查找异常信息，根据异常信息解决问题。
  - 检查应用的依赖是否与Tomcat自带的库文件冲突，尝试排除冲突的库文件。
  - 检查应用的配置文件是否正确，例如数据库连接配置、Servlet配置等。
Session丢失：
- 原因： Tomcat重启导致Session丢失、Session过期、Cookie禁用等。
- 解决方法：
  - 配置Tomcat的Session持久化，将Session数据保存到磁盘或数据库中，防止Tomcat重启导致Session丢失。
  - 延长Session过期时间。
  - 确保浏览器已启用Cookie。
内存溢出 (OutOfMemoryError)：
- 原因： 应用占用过多内存、Tomcat配置的内存不足等。
- 解决方法：
  - 优化应用代码，减少内存占用。
  - 增加Tomcat的内存配置，可以通过修改 CATALINA_OPTS 环境变量来设置Tomcat的JVM参数，例如：
```
export CATALINA_OPTS="-Xms512m -Xmx1024m"
```
  登录后复制
  -Xms 指定初始堆大小，-Xmx 指定最大堆大小。

中文乱码：

原因： 编码设置不正确。

解决方法：

在JSP页面中设置编码：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

登录后复制

在Servlet中设置编码：

response.setContentType("text/html;charset=UTF-8");
request.setCharacterEncoding("UTF-8");

登录后复制

修改Tomcat的 server.xml 文件，设置URIEncoding：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           URIEncoding="UTF-8"/>

登录后复制

除了webapps目录，还有哪些部署Java Web应用的方式？

除了将WAR文件直接复制到webapps目录进行部署，还有其他几种方式可以部署Java Web应用到Tomcat：

使用Tomcat Manager App：
- Tomcat Manager App提供了一个Web界面，允许用户上传WAR文件、部署应用、停止应用、启动应用、卸载应用等。
- 访问Tomcat Manager App的URL通常是 http://localhost:8080/manager/html。
- 需要配置Tomcat的用户和角色才能访问Manager App。
使用Context XML文件 (自动部署)：
- 在 conf/Catalina/localhost/ 目录下创建一个XML文件，文件名就是你的应用的Context Path。例如，如果你的应用叫 mywebapp.war，可以创建一个 mywebapp.xml 文件。
- Context XML文件内容如下：
```
<Context docBase="mywebapp" path="/mywebapp" reloadable="true" />
```
登录后复制
登录后复制
- docBase 属性指向你的WAR文件解压后的目录名（如果已经解压），或者WAR文件名（如果未解压）。
- path 属性定义了你的应用的Context Path，用户通过这个路径访问你的应用。
- reloadable="true" 允许Tomcat在应用文件发生变化时自动重新加载应用，方便开发调试。
- Tomcat启动时会自动加载并部署这些Context XML文件中定义的应用。
使用JNDI (Java Naming and Directory Interface)：
- JNDI是一种用于查找和访问资源的Java API。
- 可以通过JNDI配置数据源、邮件服务器等资源，然后在应用中使用这些资源。
- 需要在Tomcat的 context.xml 文件或应用的 web.xml 文件中配置JNDI资源。
使用Maven Tomcat插件：
- Maven Tomcat插件允许你通过Maven命令部署Java Web应用到Tomcat。
- 需要在Maven项目的 pom.xml 文件中配置Tomcat插件。
- 可以使用 mvn tomcat7:deploy 或 mvn tomcat8:deploy 命令部署应用。
使用Cargo：
- Cargo是一个通用的容器管理框架，支持多种Java EE容器，包括Tomcat。
- 可以使用Cargo的Maven插件或Ant任务部署Java Web应用到Tomcat。