IDEA启动Tomcat9.0.x

2022-03-07

字数统计: 1.1k字 | 阅读时长≈ 5分

IDEA启动Tomcat9.0.x

为了调试一下tomcat装载servlet的过程，在idea运行tomcat源码的过程中遇到了很多问题，在此记录一下。

下载链接：https://tomcat.apache.org/download-90.cgi

0x00 安装过程

下载完成之后之后解压，在解压后的文件夹里创建一个pom.xml文件

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0"

         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">



    <modelVersion>4.0.0</modelVersion>

    <groupId>org.apache.tomcat</groupId>

    <artifactId>Tomcat8.5</artifactId>

    <name>Tomcat8.5</name>

    <version>8.5</version>



    <build>

        <finalName>Tomcat8.5</finalName>

        <sourceDirectory>java</sourceDirectory>

        <testSourceDirectory>test</testSourceDirectory>

        <resources>

            <resource>

                <directory>java</directory>

            </resource>

        </resources>

        <testResources>

           <testResource>

                <directory>test</directory>

           </testResource>

        </testResources>

        <plugins>

            <plugin>

                <groupId>org.apache.maven.plugins</groupId>

                <artifactId>maven-compiler-plugin</artifactId>

                <version>2.3</version>

                <configuration>

                    <encoding>UTF-8</encoding>

                    <source>1.8</source>

                    <target>1.8</target>

                </configuration>

            </plugin>

        </plugins>

    </build>



    <dependencies>

        <dependency>

            <groupId>junit</groupId>

            <artifactId>junit</artifactId>

            <version>4.12</version>

            <scope>test</scope>

        </dependency>

        <dependency>

            <groupId>org.easymock</groupId>

            <artifactId>easymock</artifactId>

            <version>3.4</version>

        </dependency>

        <dependency>

            <groupId>ant</groupId>

            <artifactId>ant</artifactId>

            <version>1.7.0</version>

        </dependency>

        <dependency>

            <groupId>wsdl4j</groupId>

            <artifactId>wsdl4j</artifactId>

            <version>1.6.2</version>

        </dependency>

        <!-- https://mvnrepository.com/artifact/javax.xml/jaxrpc -->
        <dependency>
            <groupId>javax.xml</groupId>
            <artifactId>jaxrpc</artifactId>
            <version>1.1</version>
        </dependency>


        <dependency>

            <groupId>org.eclipse.jdt.core.compiler</groupId>

            <artifactId>ecj</artifactId>

            <version>4.5.1</version>

        </dependency>

</project>

然后用idea打开，maven导入依赖即可

找到org.apache.catalina.startup.Bootstrap就能找到主函数入口

0x01 遇到的问题

报错：程序包aQute.bnd.annotation.spi不存在

解决：在 pom.xml中添加以下依赖

<dependency>
    <groupId>biz.aQute.bnd</groupId>
    <artifactId>biz.aQute.bndlib</artifactId>
    <version>5.2.0</version>
    <scope>provided</scope>
</dependency>

报错：Error:(320, 45) java: 找不到符号

符号: 变量 VERSION_9
位置: 类 org.eclipse.jdt.internal.compiler.impl.CompilerOptions

解决：统一将错误改为VERSION_1_8即可 (或者改为你项目的JDK版本 )

报错：java: 程序包com.unboundid.ldap.listener不存在

解决：在 pom.xml中添加以下依赖

<dependency>
    <groupId>com.unboundid</groupId>
    <artifactId>unboundid-ldapsdk</artifactId>
    <version>6.0.0</version>
</dependency>

报错：程序包trailers不存在

解决：复制 apache-tomcat-9.0.59-src\webapps\examples\WEB-INF\classes\trailers 整个目录至test目录下

报错：找不到符号：变量CookieFilter

解决：复制/tomcat/webapps/examples/WEB-INF/classes/util/CookieFilter.java至/test/util目录下。

IDEA可能会有缓存，需要Rebuild Project，或者刷新一下maven。

报错：程序包org.easymock不存在

解决：在pom.xml中添加以下依赖

<dependency>
    <groupId>org.easymock</groupId>
    <artifactId>easymock</artifactId>
    <version>4.3</version>
</dependency>

解决控制台日志中文乱码问题：

查看乱码打印日志的类后发现，其调用的是org.apache.tomcat.util.res.StringManager#getString(java.lang.String)方法或org.apache.jasper.compiler.Localizer#getMessage(java.lang.String)方法获取的日志内容。根本原因是在调用java.util.ResourceBundle#getString方法时未指定编码字符集为”UTF-8“，进行强制类型转换将java.lang.Object强转成java.lang.String导致。

解决方案：

修改以下两个方法中的代码

org.apache.jasper.compiler.Localizer#getMessage(java.lang.String)

由