普元EOS7.x及以下版本升级Tomcat8
问题描述:
在使用普元EOS开发项目时,如果升级应用服务器到Tomcat8,在IDE中调试逻辑流时会报错:
the valid characters are defined in RFC 7230 and RFC 3986
原因分析:
高版本tomcat中的有一个新特性:就是严格按照 RFC 3986规范进行访问解析,而 RFC 3986规范定义了Url中只允许包含英文字母(a-zA-Z)、数字(0-9)、-_.~4个特殊字符以及所有保留字符(RFC3986中指定了以下字符为保留字符:! * ’ ( ) ; : @ & = + $ , / ? # [ ])。
如果系统传参时,参数中包含有不在RFC3986规范中的字符,就会报这个错。
解决方法:
- 优雅解决:若参数只额外包含了“|{}”这三个字符,打开文件tomcat8/conf/catalina.properties,找到最后注释掉的一行 #tomcat.util.http.parser.HttpParser.requestTargetAllow=| ,改成tomcat.util.http.parser.HttpParser.requestTargetAllow=|{},表示把“|{}”这三个字符放行。此办法适合json传参。
- 源码修改:若参数包含了RFC 3986规范外且也不在“|{}”这三个中的字符,如字符“空格"#<>^`”等,Tomcat8是不会放行的。要放这些字符,就要修改源码:用反编译软件打开tomcat8/lib/tomcat-coyote.jar中的org.apache.tomcat.util.http.parser.HttpParser.class,找到IS_NOT_REQUEST_TARGET数组定义的值设置(IS_NOT_REQUEST_TARGET是一个长度128布尔型的数组,对应0~127的ASCII是否被拦截),将要放行字符对应的值改为false,然后将重新编译的HttpParser.class替换tomcat-coyote.jar中的对应文件。jar包更新后,替换tomcat8中的原有tomcat-coyote.jar。
普元EOS中使用xml做为参数格式,包含了“<>/”等字符,因此只能使用第二种解决办法。