Tomcat 启动时卡住问题排查及解决方法

问题现象

在启动 Tomcat 时，控制台输出日志较少，没有显示任何正在启动的进程，且进程状态一直卡在某个进程上，无法启动成功。

问题原因

• 防火墙限制

在部分云服务器或者企业内部网络环境下，会有防火墙限制，导致 Tomcat 无法正常启动。可以通过关闭防火墙或者添加相应的端口规则来解决。

• JVM 堆栈调整不合理

如果在 Tomcat 启动过程中，JVM 堆栈大小设置不合理，可能会导致启动时间过长而卡住。

• Tomcat 配置文件错误

配置文件错误可能会导致启动过程出现错误，导致启动卡住。

解决方法

方法一：检查防火墙限制

首先，检查云服务器或者内部网络环境下是否存在防火墙限制。可通过关闭防火墙或者添加相应的端口规则来解决。

以 CentOS 7 系统为例：

# 关闭防火墙
systemctl stop firewalld.service

# 禁止防火墙开机启动
systemctl disable firewalld.service

# 添加端口规则
firewall-cmd --zone=public --add-port=8080/tcp --permanent

# 重新加载防火墙规则
firewall-cmd --reload

方法二：调整 JVM 堆栈大小

在 Tomcat 启动脚本中，可以通过设置环境变量 JAVA_OPTS 来调整 JVM 堆栈大小。可以根据服务器的配置情况来进行调整，一般建议设置为服务器内存的一半。

例如，在运行 Tomcat 的 shell 脚本中添加以下代码：

# 设置 JVM 堆最大值为 1024m
export JAVA_OPTS="-Xmx1024m"

方法三：检查 Tomcat 配置文件

错误的配置文件可能会导致 Tomcat 启动过程中出现错误而卡住。可以通过检查配置文件来解决问题。

例如，在 server.xml 中检查 <Connector> 标签是否配置正确：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

或者，在 catalina.out 控制台日志中查看错误信息，定位问题所在。

示例说明

• 示例一：防火墙限制引起的问题

在启动 Tomcat 的过程中，控制台无任何输出，进程一直卡在一个状态下。

经排查发现，是因为在云服务器上有防火墙限制，导致 Tomcat 无法正常启动。通过关闭防火墙，问题得到了解决。

• 示例二：JVM 堆栈调整不合理引起的问题

在启动 Tomcat 的过程中，控制台输出日志较少，进程一直卡在某个进程上，无法启动成功。

经排查发现，是因为 JVM 堆栈大小设置过小，导致启动时间过长而卡住。通过调整 JAVA_OPTS 环境变量来解决问题。