记录一次生产环境偶发HTTP响应406报错问题

俞兆鹏

已于 2024-06-26 20:50:51 修改

阅读量8.9k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： java Spring Cloud实战文章标签： java http406 406报错

于 2022-04-11 19:32:34 首次发布

本文链接：https://blog.csdn.net/zhaopeng_yu/article/details/124106391

Spring Cloud实战同时被 2 个专栏收录

15 篇文章

订阅专栏

java

11 篇文章

订阅专栏

本文讲述了在生产环境中遇到的一个偶发406错误问题，该问题仅在生产环境出现，表现为三千次调用中有十几次报错。经过排查，发现原因是接口路径以IP结尾，当IP地址为以123结尾时，被Tomcat误识别为MIME类型，导致406错误。解决方案是修改接口参数避免以IP结尾。此问题强调了开发中注意特殊字符影响的重要性，并提醒在解决偶发问题时要关注细节和规律。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

背景

今天在生产环境碰到了一个不算复杂，但是容易让人抓狂的问题。我们的一个Rest接口偶发的报406错误，只在生产环境中出现，大致估算是三千次调用中会出现十几次的这个错误，在测试环境一直无法复现。
首先查了下HTTP的406状态码语意，如下：

406 (SC_NOT_ACCEPTABLE)表示请求资源的MIME类型与客户端中Accept头信息中指定的类型不一致。
例如：客户端请求html类型资源，但是服务端返回了json数据，就回报406错误

我们的接口是REST 接口，请求的类型和返回的都是JSON 类型的应该是不会有这个问题的，而且还是偶发的，一个月可能会出现几次，大致情况就是这样。

排查思路

首先，我先看了一下这个接口代码，我写了个类似的接口，path变量参数是IP，

@RestController
public class TestController {

	@Resource
	private TestService testService;

	@PostMapping("/test/{ip}")
	public String doReq( @PathVariable("ip")String ip){
		String result = testService.doSomething(ip);
		return result;
	}
}

因为这块代码不是我写的，所以我刚看到这个代码的时候就感觉有点怪异，因为ip地址中是有特殊字符的，而且ipv6的地址中带有冒号，可能会存在歧义问题，咱们常规的接口开发中是不建议带特殊字符的。后来问题定位出来也验证了确实是这里的问题。

然后，根据406的错误语意，我们猜测是在客户端发请求的时候指定的Accept请求头有问题，我们把Accept请求头打印出来之后，也都是正常的其中“/” 就代表接受所有类型的响应，如果是这里的问题所有请求都是有问题的，不会是偶发的，所以排除了请求头的怀疑。
后来，我们又从报错的时间上开始找规律，但是报错时间毫无规律，就是偶发的，上午下午都有。
再然后，考虑到请求URI上的后缀也会影响到服务端响应类型，例如我们请求 http://test.com/a.jpg 但是服务端返回一个json也是会报406，而我们的接口地址上是以IP结尾的，IPv4地址就回有点，猜测是不是这个影响，然后通过日志观察，果然报错的请求的ip地址都是 .123结尾的，然后查询了tomcat 的mimetype ，真的是有一个类型是123 如下图：