IDEA调试Tomcat代码教程

心血来潮想自己调一下Tomcat的CVE，发现不会配Tomcat源码的运行环境，这里记录一下。

 

下载源码

这里使用的Tomcat版本是7.0.79，需要下它的源码而不是运行环境。下载地址： Index of /dist/tomcat/tomcat-7/v7.0.79/src

下载对应的版本即可

 

项目部署

解压之后再项目的根目录创建 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>Tomcat7.0.79</artifactId>
<name>Tomcat7.0.79</name>
<version>7.0</version>

<properties>
    <java.version>1.8</java.version>
</properties>

<dependencies>
    <dependency>
        <groupId>ant</groupId>
        <artifactId>ant</artifactId>
        <version>1.7.0</version>
    </dependency>
    <dependency>
        <groupId>ant</groupId>
        <artifactId>ant-apache-log4j</artifactId>
        <version>1.6.5</version>
    </dependency>
    <dependency>
        <groupId>ant</groupId>
        <artifactId>ant-commons-logging</artifactId>
        <version>1.6.5</version>
    </dependency>
    <dependency>
        <groupId>wsdl4j</groupId>
        <artifactId>wsdl4j</artifactId>
        <version>1.6.2</version>
    </dependency>
    <dependency>
        <groupId>javax.xml.rpc</groupId>
        <artifactId>javax.xml.rpc-api</artifactId>
        <version>1.1</version>
    </dependency>
    <dependency>
        <groupId>org.eclipse.jdt.core.compiler</groupId>
        <artifactId>ecj</artifactId>
        <version>4.5.1</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<build>
    <finalName>Tomcat7.0</finalName>
    <sourceDirectory>java</sourceDirectory>
    <resources>
        <resource>
            <directory>java</directory>
        </resource>
    </resources>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.5</version>
            <configuration>
                <encoding>UTF-8</encoding>
                <source>${java.version}</source>
                <target>${java.version}</target>
            </configuration>
        </plugin>
    </plugins>
</build>

</project>

在项目根目录下创建文件夹命名为home，名字自己可以随便取。

然后，将项目的conf和webaps剪切至home所在目录。并且在home目录下创建logs、work、lib三个目录。

然后在IDEA中打开项目，待项目成功导入之后，在Run/Debug Configurations创建一个Application，配置如下：

• MainClass填写org.apache.catalina.startup.Bootstrap（若下载的tomcat不是源码版，会找不到bootstrap类）
• VM options填写-Dcatalina.home="F:\xxx\home"
F:\xxx\home为你之前home目录完整路径

配置好之后点击Run启动tomcat服务器，默认运行在8080端口，现在就可以愉快地调试了。

 

问题解决

当我把环境换到Tomcat 8的时候当访问JSP的时候却报错了，比如访问：http://localhost:8080/index.jsp 或者我们自己的项目的时候会出现JSP无法编译的错误。

java.lang.NullPointerException  
    at org.apache.jasper.JspCompilationContext.getTldResourcePath(JspCompilationContext.java:536)  
    at org.apache.jasper.compiler.Parser.parseTaglibDirective(Parser.java:410)  
    at org.apache.jasper.compiler.Parser.parseDirective(Parser.java:469)  
    at org.apache.jasper.compiler.Parser.parseElements(Parser.java:1430)  
    at org.apache.jasper.compiler.Parser.parse(Parser.java:139)  
    at org.apache.jasper.compiler.ParserController.doParse(ParserController.java:227)  
    at org.apache.jasper.compiler.ParserController.parse(ParserController.java:100)  
    at org.apache.jasper.compiler.Compiler.generateJava(Compiler.java:199)  
    at org.apache.jasper.compiler.Compiler.compile(Compiler.java:356)  
    at org.apache.jasper.compiler.Compiler.compile(Compiler.java:336)  
    at org.apache.jasper.compiler.Compiler.compile(Compiler.java:323)  
    at org.apache.jasper.JspCompilationContext.compile(JspCompilationContext.java:570)  
    at org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:356)  
    at org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:396)  
    at org.apache.jasper.servlet.JspServlet.service(JspServlet.java:340)  
    at javax.servlet.http.HttpServlet.service(HttpServlet.java:725)  
    at org.wso2.carbon.ui.JspServlet.service(JspServlet.java:155)  
    at org.wso2.carbon.ui.TilesJspServlet.service(TilesJspServlet.java:80)  
    at javax.servlet.http.HttpServlet.service(HttpServlet.java:725)

原因是我们直接启动org.apache.catalina.startup.Bootstrap的时候没有加载org.apache.jasper.servlet.JasperInitializer，从而无法编译JSP。这在Tomcat6/7是没有这个问题的。解决办法是在tomcat的源码org.apache.catalina.startup.ContextConfig中手动将JSP解析器初始化：

context.addServletContainerInitializer(new JasperInitializer(), null);

这样就解决问题了。

 

参考资料

在Intellij环境下调试tomcat源码

【基于IntelliJ IDEA环境】Tomcat8源码的调试和项目部署