搭建Tomcat源码阅读环境，无bug运行调试。答应我，和我一起学习Tomcat，不要放弃！(1)

先自我介绍一下，小编浙江大学毕业，去过华为、字节跳动等大厂，目前阿里P7

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上Java开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以添加V获取：vip1024b （备注Java）

正文

（2）替换webapps和加 lib 包

因为源码包webapps下示例项目WEB-INF/classes/下的.java没有编译，没有.class文件，所以可将整个webapps删除，并复制安装包中的webapps到源码包。

源码包中新建lib目录，从安装包中的lib目录复制jasper.jar到源码包的lib目录。这样做的目的有两个：

• Tomcat运行时会默认扫描lib目录，没有lib目录虽然不会报错，但是控制台会有警告日志，提示lib目录不存在。

• 安装包lib下jar包很多，没必要都复制过来，按需复制了jasper.jar，虽然jasper.jar中的代码和源码中的org.apache.jasper完全重了，但是这个jar包里有非常重要的配置信息，定义了javax.servlet.ServletContainerInitializer的实现类是org.apache.jasper.servlet.JasperInitializer，Tomcat启动时，Context的生命周期监听器ContextConfig.configureStart会扫描lib目录下的jar里面的配置信息，做一些类初始化操作。这里就是主动实例化JasperInitializer，不然访问jsp就会报错。（百度的教程千篇一律，都是在源码里写死加一个JasperInitializer的初始化，不推荐这样做，一定要找到原因。）

（3）运行Bootstrap#main

org.apache.catalina.startup.Bootstrap#main 是Tomcat一键启停的源头，运行这个main方法之前需要指定一下配置的位置，Tomcat必须要引用server.xml等配置才可以运行起来。

需要先了解两个概念：

• catalina.home是Tomcat安装目录，也是公共目录，如bin、lib都是所有web共享的。

• catalina.base是web项目部署目录，也是工作目录，如conf、logs、webapps等，web可私有。

Tomcat读的一些配置，默认都是在这两个目录下，比如conf、webapps、lib等。我这里VM options设置了catalina.home和catalina.base都是源码目录，并指定了Log的配置。

-Dcatalina.home=C:/study/tomcat/apache-tomcat-8.5.9-src

-Dcatalina.base=C:/study/tomcat/apache-tomcat-8.5.9-src

-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager

-Djava.util.logging.config.file=C:/study/tomcat/apache-tomcat-8.5.9-src/conf/logging.properties

（4）运行并访问

完成以上三步，就可以运行了：

如果test目录有报错，可删除报错的位置（最好不要删除整个test目录，可以自己在test目录里写测试类debug）。正常运行后，在浏览器中访问http://127.0.0.1:8080/ , 点击页面中的超链接如Documentation、Configuration等都可以正常访问。

（5）-config指定配置路径运行

webapps下的web项目是会自动部署的，但是实际生产中，不太可能让所有的web项目都部署在webapps下，不太可能启动一个Tomcat，运行所有web，一旦一个web运行异常导致Tomcat挂了，其他web也会受到影响。所以一般通过-config指定配置，一个web运行一个Tomcat，保证进程隔离。

Program arguments, example1.conf是定制的server.xml配置

-config C:/study/tomcat/conf/example1.conf start

example1.conf：

<?xml version='1.0' encoding='utf-8'?>

<Resource name=“UserDatabase” auth=“Container”

type=“org.apache.catalina.UserDatabase”

description=“User database that can be updated and saved”

factory=“org.apache.catalina.users.MemoryUserDatabaseFactory”

pathname=“conf/tomcat-users.xml” />

<Connector executor=“tomcatThreadPool” port=“8012” protocol=“org.apache.coyote.http11.Http11NioProtocol”

connectionTimeout=“60000”

acceptCount= “10000”

redirectPort=“8443” URIEncoding=“UTF-8” maxPostSize=“-1” maxHttpHeaderSize =“102400”/>

<Realm className=“org.apache.catalina.realm.UserDatabaseRealm”

resourceName=“UserDatabase”/>

<Valve className=“org.apache.catalina.valves.AccessLogValve” directory=“C:/study/tomcat/logs/”

prefix=“example1.” suffix=“.txt”

pattern=“%h %l %u %t “%r” %s %b” />

3、Tomcat10.0.6源码运行

和apache-tomcat-8.5.9-src的搭建过程差不多，稍有不同的地方是一些依赖需要调整。（Tomcat10.0.6中直接复制整个安装包的lib到源码包中运行不会报错，所以可整个复制过去）

pom.xml比8.5.9版本多两个依赖jakartaee-migration和biz.aQute.bndlib：

<?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”>

4.0.0

org.apache.tomcat

Tomcat10.0.6

Tomcat10.0.6

10.0.6

Tomcat10.0.6

java

java

test

org.apache.maven.plugins

maven-compiler-plugin

2.3

UTF-8

1.8

1.8

junit

junit

4.12

test

org.easymock

easymock

3.4

ant

ant

1.7.0

wsdl4j

wsdl4j

1.6.2

javax.xml

jaxrpc

1.1

org.apache.tomcat

jakartaee-migration

1.0.0

biz.aQute.bnd

biz.aQute.bndlib

5.3.0

provided

依赖中去掉了ecj，因为这个依赖maven仓库中最新版本也满足不了Tomcat10.0.6，需要从Tomcat10.0.6的安装包lib中复制ecj-4.18.jar到源码包的lib下，同时需要手动指定依赖：

依赖调整好以后，其他操作都和apache-tomcat-8.5.9-src一样。但是运行10.0.6后控制台输出有一些乱码，也不是中文乱码，尝试调试编码，没有解决。（有解决乱码的同学可以告知一下）

三、搭建源码阅读环境

---

阅读学习Tomcat源码，需要三件事：

1. 看书入门，这里推荐两本关于Tomcat的书《Tomcat内核设计剖析》汪建 和《Tomcat架构解析》刘光瑞。

2. 搭建Tomcat源码运行环境，并debug。

3. 阅读Tomcat最新源码，多版本比对源码。Tomcat在Github中开源，可git clone 最新代码到本地。阅读最新源码有一个好处就是可以看到每次修改的提交记录。

如下是本人搭建的源码阅读环境，可git clone一起学习：

https://gitee.com/stefanpy/tomcat-source-code-learning

四、总结：如何阅读源码

---

搭建源码阅读环境必不可少，一定要做到手里有书，眼里有源码，心里有debug。

书，具有引导和总结作用，Tomcat源码那么多，那么复杂，不知道从哪里开始读。可以先跟着书的目录，按章学习，从整体到细节，从外到内，从简到繁，快速建立起一个Tomcat基础架构网络：

1. Tomcat是一个HTTP服务器和Servlet容器，有两个核心组件：连接器和容器，链接器实现HTTP功能，容器实现装载Servlet的功能。

2. 一个Server可以包含多个Service，一个Service包含多个Conector和一个Engine，一个Engine包含多个Host，一个Host包含多个Context，一个Context包含多个Wrapper，这些容器名称和层次关系是不是有些晕？一个Context就是一个熟悉的web服务，Wrapper可以理解为对Servlet的包装。

最后

现在正是金三银四的春招高潮，前阵子小编一直在搭建自己的网站，并整理了全套的**【一线互联网大厂Java核心面试题库+解析】：包括Java基础、异常、集合、并发编程、JVM、Spring全家桶、MyBatis、Redis、数据库、中间件MQ、Dubbo、Linux、Tomcat、ZooKeeper、Netty等等**

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip1024b （备注Java）

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！
可以理解为对Servlet`的包装。

最后

现在正是金三银四的春招高潮，前阵子小编一直在搭建自己的网站，并整理了全套的**【一线互联网大厂Java核心面试题库+解析】：包括Java基础、异常、集合、并发编程、JVM、Spring全家桶、MyBatis、Redis、数据库、中间件MQ、Dubbo、Linux、Tomcat、ZooKeeper、Netty等等**

[外链图片转存中…(img-MiDsPjCw-1713472347365)]

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip1024b （备注Java）
[外链图片转存中…(img-CK1k67S1-1713472347366)]

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！