Tomcat异常实践总结

Posted 2022-06-11 程序员小默

【1】413 request header is too large

请求头超过了tomcat的限值。本来post请求是没有参数大小限制，但是服务器有自己的默认大小。

解决方案：修改 tomcat 的 server.xml 的配置文件，增加 请求字段长度。

<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443"  
 maxPostSize="6553600" maxHttpHeaderSize ="1024000" URIEncoding="UTF-8"/>

---

如果是nginx+Tomcat，可以再NGINX配置文件nginx.conf中添加配置：

可以选择在http 中设置：client_max_body_size   20m;
也可以选择在server 中设置：client_max_body_size   20m;
还可以选择在location 中设置：client_max_body_size   20m;

三者有区别

设置到http内，控制全局nginx所有请求报文大小
设置到server内，控制该server的所有请求报文大小
设置到location内，控制满足该路由规则的请求报文大小

---

【2】this web application instance has been stopped already

背景：未停止Tomcat服务时，直接更新服务器上面项目。使用命令​​bin/shutdown.sh​​​停止又重启。异常如下图所示(有时会出现同一tomcat多个进程现象)：

原因是因为在tomcat重启的时候，之前的tomcat的线程还没有完全关闭，最新启动tomcat就会报这个异常，只要把tomcat的server.xml 中的​​​reloadable=”true”​​​ 改成​​false​​就OK

解决方案：

修改tomcat conf目录下的context.xml,找到<Context>标签，
把reloadble的属性值设为：reloadable="false"，即<Context reloadable="false">。

reloadable=="true"时，则Tomcat会自动检测WEB-INF/lib和WEB-INF/classes目录的变化，自动装载新的应用程序，可以在不重启Tomcat情况下使用新的应用程序。

当然，针对上面异常情况，还可以暴力一点直接使用kill命令杀掉进程并手动启动Tomcat：

//找到tomcat实例对应pid
ps -ef|grep tomcat

kill -9 pid

---

如果确实停止了，但是server.xml根本没有context标签怎么办?

考虑下是不是项目启动出错！查看tomcat下logs中的localhost.xxxx-xx-xx.log，而不仅仅是查看catalina.out。

---

【3】Target runtime Apache Tomcat v7.0 is not defined

如下图所示，eclipse中导入项目提示如下：

这是因为原先项目使用Tomcat7运行，当前环境使用server非Tomcat7。

---

【4】Invalid character found in the request target

Invalid character found in the request target. The valid characters are defined in RFC 7230 and RFC

Linux部署项目(本地运行良好,Tomcat版本7)后出现标题所示错误，查询资料得知，tomcat8版本增加了对请求的校验。

RFC3986文档规定，Url中只允许包含英文字母（a-zA-Z）、数字（0-9）、-_.~4个特殊字符以及所有保留字符。

RFC3986中指定了以下字符为保留字符：

!*();:@&=+$,/?#[]

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

• 空格Url在传输的过程，或者用户在排版的过程，或者文本处理程序在处理Url的过程，都有可能引入无关紧要的空格，或者将那些有意义的空格给去掉
• 引号以及<>引号和尖括号通常用于在普通文本中起到分隔Url的作用
• #通常用于表示书签或者锚点
• %百分号本身用作对不安全字符进行编码时使用的特殊字符，因此本身需要编码
• ​​|\\^[]​​~`某一些网关或者传输代理会篡改这些字符

故，该错误是由于请求中url参数“违法”造成的。解决办法：

① 降低tomcat版本；

② 对url中参数进行URL编码；

博文采用第二种方法，如下图所示：

---

【5】Tomcat启动卡100%

启动的时候一直卡在100%处，网上有的说是代理问题(关于这个可以自行百度)，但是这里不对。从未配置过代理，而且是本地启动，和代理没关系。

这里原因在于引入了一个commons-validator.jar，导致进行很多校验，短时间内看Tomcat卡在了100%处，时间长一点就会由于超时启动失败(超时这个可以设置时间)。将该jar去掉，重新启动，正常！

---

【6】Invalid character found in method name. HTTP method names must be tokens

Tomcat的header缓冲区大小不够,只需要在server.xml中增加maxHttpHeaderSize字段即可:

<Connector URIEncoding="UTF-8" port="8080" protocol="org.apache.coyote.http11.Http11NioProtocol"
useBodyEncodingForURI="false"
enableLookups="false"
 connectionTimeout="20000"
 redirectPort="8443" maxHttpHeaderSize="你想要的大小"/>

如果是SpringBoot项目，则需要在application.yml文件中，进行如下修改：

server:
  port: 项目端口
  # 下面这个参数是为解决问题而新增的
  tomcat:
    max-http-header-size: 819200