【Tomcat】 apache-tomcat-8.5.56-src源码下载以及启动运行

最新推荐文章于 2025-03-28 15:07:30 发布

云川之下

最新推荐文章于 2025-03-28 15:07:30 发布

阅读量2.9k

点赞数 3

分类专栏： Tomcat

本文链接：https://blog.csdn.net/m0_45406092/article/details/111054941

版权

Tomcat 专栏收录该内容

17 篇文章

订阅专栏

文章目录

1. 下载Tomcat源码

源码下载地址: https://tomcat.apache.org/download-80.cgi
在这里插入图片描述

注意：源码包和编译包都要下载，后面我们会用到编译包的lib文件夹，里面是额外的一些依赖，在运行的时候，需要用到

历史版本，都是8下面的子版本：
https://archive.apache.org/dist/tomcat/tomcat-8/
在这里插入图片描述

如果想找大版本为5的话，直接修改url：
https://archive.apache.org/dist/tomcat/tomcat-5/

2. 项目配置

2.1 下载完成后打开idea, 选择File->Open->选择tomcat的源码目录

在这里插入图片描述

2.2 然后到项目配置中设置JDK和源码目录

File->Project Structure->project SDK
在这里插入图片描述

2.3 配置maven下载依赖的包&构建

需要通过Maven组织文件，因此需要在根目录下创建目录中新建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>
    </dependencies>
  
</project>

保证依赖的包下载成功或引入成功：

在这里插入图片描述
如果是引入失败，则重新引入，参考：《IntelliJ IDEA更新maven依赖包》

构建项目，请先clean然后install 保证项目没有问题：
在这里插入图片描述

2.4 构建中出现的异常

2.4.1 TestCookieFilter错误

如果启动或者编译过程中出现Test测试代码报错，注释该代码即可。Tomcat源码util.TestCookieFilter类会报错，将其注释即可：
在这里插入图片描述

3. 启动配置

配置启动参数，我用的是Idea，在右上角点击配置，然后添加一个Application，此时需要配置三个参数：

在这里插入图片描述

Main class : 固定填写org.apache.catalina.startup.Bootstrap
表示Tomcat的启动类是哪个
VM options : -Dcatalina.home="war包存放路径"
```
-Dcatalina.home=C:\Users\zhangsan\IdeaProjects\apache-tomcat-8.5.56-src\catalina-home
```
例如我是在源码路径下建立了一个catalina-home文件夹，catalina-home文件里有work、webapps、logs、lib、conf文件夹，这里面其实就是Tomcat的工作路径了，这几个目录可以从编译包中复制过来。

catalina-home\webapps可以为空，也可以保留如下几个工程，这是后面访问http://localhost:8080/展示tomcat主页面的工程，如果为空，自然啥也看不到，也不好证明是否启动成功，建议保留：

建议删除webapps\docs,webapps\examples，这几个会让后台日志显示一些错误信息，并且启动慢；不删也没关系，不影响启动。

lib的目录可以为空，当catalina-home\webapps为空，lib就可以为空，如果catalina-home\webapps保留了上述建议的工程，此处必须加上jsp相关的依赖，因为欢迎界面是jsp写的：

在这里插入图片描述

Use classpath of module : 设置为新建文件夹的模块

配置完成以后，直接启动就行，此时或许会报错，因为源码中有许多我们用不到的测试类，我们可以全给删除了，然后再启动即可，下图为启动成功后，浏览器可以访问的配置页面：

访问http://localhost:8080/
在这里插入图片描述
启动成功的日志：

信息: å¼€å§‹åè®®å¤„ç†å¥æŸ„["http-nio-8080"]
十二月 19, 2020 7:11:26 下午 org.apache.catalina.startup.Catalina start
信息: Server startup in 11463 ms

注意：启动日志必须出现 Server startup in 11463 ms，否则就不算启动成功；
如果有一些错误日志，但是仍打印Server startup in 11463 ms，程序仍有可能是ok的，不影响主体功能的使用。

4. 碰到的问题

如果catalina-home/webapps下有examples过程，启动过程可能会有报错信息提示“java.lang.ClassNotFoundException: listeners.ContextListener”，但是不影响程序的启动：

十二月 19, 2020 7:11:19 下午 org.apache.catalina.startup.HostConfig deployDirectory
信息: æŠŠweb åº”ç”¨ç¨‹åºéƒ¨ç½²åˆ°ç›®å½• [C:\Users\10173694\IdeaProjects\apache-tomcat-8.5.56-src\catalina-home\webapps\examples]
十二月 19, 2020 7:11:21 下午 org.apache.catalina.core.StandardContext listenerStart
严重: é
ç½®åº”ç”¨ç¨‹åºç›‘å¬å™¨[listeners.ContextListener]é”™è¯¯
java.lang.ClassNotFoundException: listeners.ContextListener
	at org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1358)
	at org.apache.catalina.loader.WebappClassLoaderBase.loadClass(WebappClassLoaderBase.java:1180)