记一次使用 Tomcat 插件启动 Web 项目不成功的经历

问题背景

在个人项目中使用 Tomcat 插件启动 Web 工程，pom 文件中 Tomcat 插件配置如下：

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <configuration>
                    <path>/</path>
                    <port>8080</port>
                </configuration>
            </plugin>
        </plugins>
</build>

运行配置如下：

Jietu2.jpg

启动项目，没有任何问题。
以上过程是在公司进行的，本机以及项目所依赖的虚拟机都处于公司的内网。
当我回到家里，把项目从 Git 上拉下来，导入 idea，启动，出现问题了。
本来成功启动时控制台输出的日志如下图：

image.png

但是此时启动日志却是这样：

Jietu1.jpg
少了 “Starting ProtocolHandler ["http-bio-8080"]”，也就是启动失败，没有报错信息，target/tomcat/logs 目录下也没有日志文件存在。

分析

没有日志，也就没办法知道启动失败的原因，于是需要在 Tomcat 中配置
log4j，查看更详细的日志。Tomcat 的 Maven 插件日志配置方法如下：

<build>
        <plugins>
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <artifactId>tomcat7-maven-plugin</artifactId>
                <configuration>
                    <path>/</path>
                    <port>8080</port>
                    <!--log4j配置文件位置-->
                    <systemProperties>
                        <log4j.configuration>file:src/main/resources/properties/log4j.properties</log4j.configuration>
                    </systemProperties>
                </configuration>
            </plugin>
        </plugins>
</build>

在项目的 src/main/resources/properties/ 路径下新建 log4j.properties 文件，内容如下：

log4j.rootLogger = INFO, CATALINA

# Define all the appenders
log4j.appender.CATALINA = org.apache.log4j.DailyRollingFileAppender
log4j.appender.CATALINA.File = ${catalina.base}/logs/catalina
log4j.appender.CATALINA.Append = true
log4j.appender.CATALINA.Encoding = UTF-8
# Roll-over the log once per day
log4j.appender.CATALINA.DatePattern = '.'yyyy-MM-dd'.log'
log4j.appender.CATALINA.layout = org.apache.log4j.PatternLayout
log4j.appender.CATALINA.layout.ConversionPattern = %d [%t] %-5p %c- %m%n

log4j.appender.LOCALHOST = org.apache.log4j.DailyRollingFileAppender
log4j.appender.LOCALHOST.File = ${catalina.base}/logs/localhost
log4j.appender.LOCALHOST.Append = true
log4j.appender.LOCALHOST.Encoding = UTF-8
log4j.appender.LOCALHOST.DatePattern = '.'yyyy-MM-dd'.log'
log4j.appender.LOCALHOST.layout = org.apache.log4j.PatternLayout
log4j.appender.LOCALHOST.layout.ConversionPattern = %d [%t] %-5p %c- %m%n

log4j.appender.MANAGER = org.apache.log4j.DailyRollingFileAppender
log4j.appender.MANAGER.File = ${catalina.base}/logs/manager
log4j.appender.MANAGER.Append = true
log4j.appender.MANAGER.Encoding = UTF-8
log4j.appender.MANAGER.DatePattern = '.'yyyy-MM-dd'.log'
log4j.appender.MANAGER.layout = org.apache.log4j.PatternLayout
log4j.appender.MANAGER.layout.ConversionPattern = %d [%t] %-5p %c- %m%n

log4j.appender.HOST-MANAGER = org.apache.log4j.DailyRollingFileAppender
log4j.appender.HOST-MANAGER.File = ${catalina.base}/logs/host-manager
log4j.appender.HOST-MANAGER.Append = true
log4j.appender.HOST-MANAGER.Encoding = UTF-8
log4j.appender.HOST-MANAGER.DatePattern = '.'yyyy-MM-dd'.log'
log4j.appender.HOST-MANAGER.layout = org.apache.log4j.PatternLayout
log4j.appender.HOST-MANAGER.layout.ConversionPattern = %d [%t] %-5p %c- %m%n

log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.Encoding = UTF-8
log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern = %d [%t] %-5p %c- %m%n

# Configure which loggers log to which appenders
log4j.logger.org.apache.catalina.core.ContainerBase.[Catalina].[localhost] = INFO, LOCALHOST
log4j.logger.org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/manager] =\
INFO, MANAGER
log4j.logger.org.apache.catalina.core.ContainerBase.[Catalina].[localhost].[/host-manager] =\
INFO, HOST-MANAGER

问题解决

通过配置日志，在日志中找到了项目启动失败的原因，是因为本机无法访问本地搭建的虚拟机里的 zookeeper。

由于我当前的网络环境是在 WiFi 网络下，首先想到的是本机和虚拟机的网络没有互通，检查了下，本机和虚拟机可以互相 ping 通，但是本机却无法通过 Telnet 连接虚拟机，所以首先需要对虚拟机网络进行配置：

• 1. 虚拟机网卡 1 连接方式选择网络地址转换（NAT） :

image.png

• 2. 在虚拟机主机网络管理器中创建一个虚拟网卡：

image.png

• 3. 虚拟机网卡 2 连接方式选择仅主机（Host-Only）网络 :

image.png

• 4. 增加之后，会在虚拟机中产生一个 enp0s8 网卡，IP 地址为：192.168.56.101

image.png

完成以上步骤后，本机可以通过 Telnet 连接虚拟机。

此时，以为问题已经解决，但是重新启动项目后，还是相同的错误，于是想到可能是虚拟机防火墙的问题。

• 1. 查看虚拟机已经开放的端口：

firewall-cmd --list-ports

发现 zookeeper 的 2181 端口没有开放，于是开启 2181 端口。

• 2. 开启 2181 端口：

firewall-cmd --zone=public --add-port=2181/tcp --permanent

命令含义如下：
zone #作用域
add-port=2181/tcp #添加端口，格式为：端口/通讯协议
permanent #永久生效，没有此参数重启后失效

• 3. 然后重启防火墙：

firewall-cmd --reload

CentOS 其他防火墙命令如下：

停止防火墙：systemctl stop firewalld.service
禁止防火墙：systemctl disable firewalld.service
查看防火墙状态：systemctl status firewalld.service
启动防火墙：systemctl start firewalld.service
重启防火墙：systemctl restart firewalld.service
在开机时启用防火墙：systemctl enable firewalld.service
在开机时禁用防火墙：systemctl disable firewalld.service
查看防火墙是否开机启动：systemctl is-enabled firewalld.service;echo $?

完成以后，重新启动项目，成功。