Tomcat get 请求特殊字符的坑

1、前言

在boot+vue项目里，使用get请求传递数组，却返回400 bad request。查看URL发现，ajax将url拼接成了http://localhost:8899/get?runtimeArray[]=qwe后，后端报错

2022-05-11 18:43:26.565  INFO 5256 --- [nio-8899-exec-2] o.apache.coyote.http11.Http11Processor   : Error parsing HTTP request header
 Note: further occurrences of HTTP request parsing errors will be logged at DEBUG level.

java.lang.IllegalArgumentException: Invalid character found in the request target [/get?runtimeArray[]=qwe ]. The valid characters are defined in RFC 7230 and RFC 3986
	at org.apache.coyote.http11.Http11InputBuffer.parseRequestLine(Http11InputBuffer.java:494) ~[tomcat-embed-core-9.0.62.jar:9.0.62]
	at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:271) ~[tomcat-embed-core-9.0.62.jar:9.0.62]
	at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:65) [tomcat-embed-core-9.0.62.jar:9.0.62]
	at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:890) [tomcat-embed-core-9.0.62.jar:9.0.62]
	at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1743) [tomcat-embed-core-9.0.62.jar:9.0.62]
	at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:49) [tomcat-embed-core-9.0.62.jar:9.0.62]
	at org.apache.tomcat.util.threads.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1191) [tomcat-embed-core-9.0.62.jar:9.0.62]
	at org.apache.tomcat.util.threads.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:659) [tomcat-embed-core-9.0.62.jar:9.0.62]
	at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61) [tomcat-embed-core-9.0.62.jar:9.0.62]
	at java.lang.Thread.run(Thread.java:748) [na:1.8.0_241]

2、分析

大体一看，并不是SpringBoot报的错，而是Tomcat报的错。

从报错信息来看，数据还未处理，url就出了问题Invalid character found in the request target [/get?runtimeArray[]=qwe ]. The valid characters are defined in RFC 7230 and RFC 3986

无效的字符在请求上，说明[、]肯定不符合这两个RFC标准。

3、源码

找到at org.apache.coyote.http11.Http11InputBuffer.parseRequestLine(Http11InputBuffer.java:494) ~[tomcat-embed-core-9.0.62.jar:9.0.62]

debug后，可以看到第一个条件返回的true，第二个条用来判断chr变量的值，每个chr是从url中截取出来的字符，通过ASCII码转换为byte，[对应的ASCII码为91，]对应的为93

进入到isQueryRelaxed方法后发现，Tomcat维护了一个数组，private final boolean[] IS_QUERY_RELAXED = new boolean[ARRAY_SIZE];其大小为128，正好对应所有的ASCII 码，如果返回true，说明字符chr是个合格的字符。

经过debug发现，数组里的第91，93都为false。经过!httpParser.isQueryRelaxed(chr)返回的就是true了，然后就会走到 throw new IllegalArgumentException里，并且抛出异常。

4、解决

1、切换版本到7.0.73以下，这个不实际。

2、修改Tomcat源码，这个也不实际。

3、前端请求对URL编码。

4、修改Get方法为Post方法。

5、因{}是不安全字符，默认被 tomcat拦截。如果需要在URL中传输json数据，在catalina.properties中添加支持。

tomcat.util.http.parser.HttpParser.requestTargetAllow=|{}

5、资料

RFC 3986文档规定，Url中只允许包含英文字母（a-zA-Z）、数字（0-9）、-_.~4个特殊字符以及所有保留字符（! * ’ ( ) ; : @ & = + $ , / ? # [ ]）。

还有一些字符当直接放在Url中的时候，可能会引起解析程序的歧义，这些字符被视为不安全字符。