Apache Tomcat 新手入门指南：从安装到部署的全流程解析

Apache Tomcat 作为一款轻量级的 Java Servlet 容器，被广泛应用于开发和运行基于 Java 的 Web 应用程序（如 Servlet 和 JSP）。对于刚接触 Tomcat 的开发者来说，快速掌握其基本操作至关重要。本文将从零开始，详细介绍 Tomcat 的安装、配置、部署及常见问题的解决方法，助你轻松入门。

第一部分：环境准备与安装

1. 确认 JDK 环境

Tomcat 依赖 Java 运行环境，因此需提前安装 JDK 8 及以上版本 （推荐 JDK 11 或 17）。安装完成后，需配置 JAVA_HOME 环境变量。

验证方法 ：在命令行输入以下命令，查看是否返回正确路径：
bash 复制代码
```
echo %JAVA_HOME%   # Windows
echo $JAVA_HOME    # Linux/macOS
```

2. 下载并解压 Tomcat

访问官网 ：进入 Apache Tomcat 官网，选择稳定版本（如 Tomcat 10.x）。
- Windows 用户下载 .zip 或 .exe 安装包。
- Linux/macOS 用户选择 .tar.gz 压缩包。
解压文件 ：将下载的压缩包解压到目标目录（如 Windows 的 C:\tomcat 或 Linux 的 /opt/tomcat）。
配置环境变量（可选） ：

添加 CATALINA_HOME 变量，指向 Tomcat 的安装目录，便于后续脚本调用。

第二部分：启动与停止 Tomcat

1. 启动 Tomcat

进入 Tomcat 的 bin 目录，执行启动命令：

Windows ：双击 startup.bat，或在命令行运行：
bash 复制代码
```
startup.bat
```
Linux/macOS ：赋予脚本执行权限后运行：
bash 复制代码
```
chmod +x *.sh
./startup.sh
```

2. 验证运行状态

浏览器访问 http://localhost:8080，若显示 Tomcat 的默认欢迎页（含"Apache Tomcat"字样），则说明启动成功。

3. 停止 Tomcat

在 bin 目录下执行停止命令：

Windows ：shutdown.bat
Linux/macOS ：./shutdown.sh

第三部分：部署第一个 Web 应用

Tomcat 支持两种常见的部署方式：

方式 1：自动部署（推荐）

将打包好的 .war 文件（Web 应用程序归档文件）直接复制到 Tomcat 的 webapps 目录下。

示例：假设应用名为 myapp.war，部署后访问 http://localhost:8080/myapp 即可。
原理：Tomcat 会自动解压 .war 文件并加载应用。

方式 2：手动部署（目录结构）

在 webapps 目录下创建应用文件夹（如 myapp），并按照标准 Web 应用结构放置文件：

复制代码

myapp/
├── WEB-INF/
│   ├── web.xml        # 配置文件（定义 Servlet、过滤器等）
│   └── classes/      # 存放编译后的 Java 类文件
└── index.jsp          # 应用首页

第四部分：关键配置文件解析

1. `server.xml`（位于 `conf` 目录）

修改端口号 ：找到 <Connector port="8080" ...>，调整 port 属性值（例如改为 80 可直接通过 http://localhost 访问）。
配置虚拟主机 ：通过 <Host> 标签设置多域名映射。

2. `web.xml`（位于 `WEB-INF` 目录）

定义 Servlet ：通过 <servlet> 和 <servlet-mapping> 标签注册 Servlet 类及其访问路径。
配置欢迎页 ：设置 <welcome-file-list> 指定默认首页。

3. `context.xml`（全局或应用级配置）

数据库连接池 ：配置 JNDI 数据源，例如 MySQL 连接：

xml 复制代码

<Resource 
  name="jdbc/mydb"
  auth="Container"
  type="javax.sql.DataSource"
  driverClassName="com.mysql.cj.jdbc.Driver"
  url="jdbc:mysql://localhost:3306/mydb"
  username="root"
  password="123456"
/>

第五部分：常见问题与解决技巧

1. 端口冲突

若启动时报错 Port 8080 already in use，可通过以下步骤解决：

查找占用进程 （Linux/macOS）：
bash 复制代码
```
sudo lsof -i :8080
kill -9 <进程ID>
```
修改 Tomcat 端口 ：编辑 server.xml 中的 <Connector port> 值。

2. 权限问题

Linux/macOS 用户若无法执行脚本，需赋予权限：

bash 复制代码

chmod +x bin/*.sh

3. 应用部署失败

查看日志 ：检查 logs/catalina.out 或 logs/localhost.log 中的错误信息。
验证文件结构 ：确保 WEB-INF 和 web.xml 符合规范。

第六部分：进阶配置与优化

1. 调整 JVM 内存参数

在 bin/setenv.sh（或 setenv.bat）中添加以下内容，防止内存溢出：