Tomcat基于Coyote的HTTP 1.1协议连接器

关注

转载最新推荐文章于 2026-07-10 07:29:30 发布 3.5k 阅读 AI 写同款· GEO 优化 ›

从一次线上故障复盘：聊聊Tomcat的HTTP协议解析与那些‘非法字符‘的坑（附Wireshark实战分析）本文深度剖析Tomcat处理HTTP协议时遇到的'Invalid character found in method name'故障，结合RFC标准和Wireshark实战分析，揭示HTTP方法名的严格校验规则。通过对比主流Web容器的行为差异，提供客户端和服务端的防御性编程方案，帮助开发者避免类似协议解析问题。阅读详情

1. 模块架构

org.apache.coyote.http11包支持http1.1协议，内部分为三类：ARP、NIO、普通http，这里只对最基本的普通http（使用java的IO流，而非NIO流）作简单研究。

这个包主要有以下几个类：

Http11Protocol，实现了ProtocolHandler接口
Http11Processor，实现了ActionHook接口
InternalInputBuffer，实现了InputBuffer接口
InternalOutputBuffer，实现了OutputBuffer接口
InputFilter和OutputFilter接口，具体的实现类在 org.apache.coyote.http11.filters 中。

架构图如下所示（转自王程斯的博客）：

HTTP 1.1 Connector Architecture

处理流程：

JIOEndpoint起到一个连接池的作用，可以启动多个socket监听，一旦收到浏览器发来的请求后，把对应的socket对象通过process方法，传递给Http11ConnectionHandler，再交给Http11Processor
Http11Processor内部有个InternalInputBuffer（图上未画出），InternalInputBuffer是真正对socket中包含的字节流进行处理的，它将字节转换为Request
Request流经过滤器filters，最后到达实现了Adapter接口的容器，模块的工作就到此为止，回头继续处理下一个socket

2. 代码研究

Http11Protocol

该类是http1.1协议的ProtocolHandler实现，主要包含了内部类Http11ConnectionHandler和Http11ConnectionHandler的实例对象，它的初始化代码和过程如下：

public Http11Protocol() {
        endpoint = new JIoEndpoint(); //新建endpoint，启动若干socket server，监听服务器端口
        cHandler = new Http11ConnectionHandler(this); //协议连接处理对象，用于对socket连接的处理
        ((JIoEndpoint) endpoint).setHandler(cHandler); //一旦endpoint接收到请求，会将对应socket实例传给cHandler.process方法进行处理
        setSoLinger(Constants.DEFAULT_CONNECTION_LINGER);
        setSoTimeout(Constants.DEFAULT_CONNECTION_TIMEOUT);
        setTcpNoDelay(Constants.DEFAULT_TCP_NO_DELAY);
    }

Http11ConnectionHandler内部类则继承了AbstractConnectionHandler，它主要实现了createProcessor方法，用于将Http11Processor应用于连接处理流程中。函数内新建了一个Http11Processor实例，并将该实例绑定到ConnectionHandler上。ConnectionHandler一旦接收到从endpoint发来的处理请求，使用对应的Processor对接收到的数据进行处理，形成Request对象。

　　2. Http11Processor

这个类的作用就是生成Request（当然本质上还是InternalInputBuffer完成的），交给实现了Adapter接口的容器。它有adapter、request、response、inputbuffer、outputbuffer等几个关键字段，还有很多和http 1.1协议有关的字段和方法，用于协议的解析（这里就不对解析过程进行分析了）。

这个类对socket对象依次做如下的处理：

1) 把socket的inputstream和outputstream分别与inputbuffer和outputbuffer关联起来

2) 通过inputBuffer.parseRequestLine() 和 inputBuffer.parseHeaders() 方法，解析socket字节流中的头字段，写到request中

3) 通过prepareRequest方法组装filter，用于处理http消息体

4) adapter.service(request, response) 把生成的request和response交给容器处理

5) 如果一切顺利，开始处理socket中的下一个请求（因为http1.1是支持持续连接的，所以一个socket中可能包含多个请求），循环回到第一步

6) 如果出错，则设置response的响应码，并终止循环

其中的prepareRequest方法，是用于准备inputbuffer的filter，主要包括一下几个过程：

1) 根据之前对http头字段的解析，分别检查protocol、method、expect、user-agent和MIMEheaders，此外还检查URI的格式

2) 准备加载filter

3) 如果有transfer-encoding这个头字段，则分别设置不同编码的filter

4) 校验content-length头字段

　　3. InternalInputBuffer

这个类的主要功能是：从socket中获取字节流，将字节读入一个缓冲区buf，然后从缓冲区逐个解析http请求头以及内容。

主要的字段有：

　　request：Request对象，从缓冲区中解析出的信息会写入request中

　　buf：缓冲区，从socket的inputstream读取的字节放入此缓冲区中

　　headers : MimeHeaders，保存以键值对出现的报头，也就是除去请求报文第一行之后的所有头部

主要的方法有：

　　parseRequestLine()

　　解析请求报头的第一行，形如：GET http://class/download.microtool.de:80/somedata.exe，包括请求方法（GET or POST）、协议（http）、URI。解析后，放入request中

　　parseHeader（）

　　解析刚才parseRequestLine()之后的报头，由于RequestLine之后的报头都是以“：”分隔的键值对，因此每执行一次本方法，则在headers 中加入一个键值对，如果格式错误则返回false

　　endRequest()

　　结束一个request的处理，把多余的字节清空

　　nextRequest()

　　准备下一个request的处理，这个方法主要用来对所有的标记位和指针进行复位

　　fill()

　　从socket的inputstream中读出一定数量的字节，填充buf，在很多方法中都有用到。例如解析报头时，当发现buf已经读取完了，就调用fill重新填充buf，如果inputstream已经读完了，fill返回false。

　　4. InternalOutputBuffer

　　这个类是用来从response中读取信息，然后写入socket的outputstream中，返回给客户端的。里面的很多方法和InternalInputBuffer基本相似，有两个是专门用于处理Response的：nextRequest()和endRequest()。这两个函数的功能主要是在当前Request处理完并发出Response之后，跳转到下一个Request的处理或者结束处理。

3. org.apache.coyote.http11.upgrade

Apache在基于coyote的HTTP 1.1连接器实现模块中还实现了能够供基于HTTP 1.1的一些协议和在HTTP 1.1基础上进行操作的接口和实现，方便进行扩展。它主要有以下几个类：

UpgradeInbound接口

接口定义了基于socket数据流处理需要实现的一些接口，主要功能是当连接器从socket中读取出数据后，会通知UpgradeInbound实现类进行数据解析，即onData函数。　　

　　2. UpgradeProcessor类

这个类是基于HTTP 1.1连接器的upgrade连接器Processor的模板类，定义了一个标准的UpgradeProcessor必须要重写的读写处理函数：

// Output methods
    public abstract void flush() throws IOException;
    public abstract void write(int b) throws IOException;
public abstract void write(byte[] b, int off, int len) throws IOException;
// Input methods
    public abstract int read() throws IOException; 
    public abstract int read(boolean block, byte[] bytes, int off, int len)
            throws IOException;