记一次Content-Length引起的血案

背景

新项目上线, 发现一个奇怪的BUG, 请求接口有很小的几率返回400 Bad Request,拿到日志记录的请求的参数于POSTMAN中测试请求接口, 发现可以正常响应.

排查过程

• 首先服务器可以正常响应400 Bad Request, 排除接口故障问题.

• 对比日志过程当中发现

{
    "hello":"world"
}复制代码

接口可以正常响应业务数据.

{
    "hello":"world",
    "kw":"我是八阿哥"
}复制代码

则接口返回400错误,接口的请求方式均为post json,因而开始review代码.发如今发送请求时设置了Content-Length,在含中文字符的状况下接口均返回400,定位到缘由.请求的伪代码以下

let param = {
    "hello":"world",
    "kw":"我是八阿哥"
}

let _options = {
    headers: {
        'Content-Type': 'application/json',
        'Content-Length': JSON.stringify(param).length
    },
    url: url,
    method: 'POST',
    json: true,
    time: true,
    timeout: 5 * 1000,
    body: param
}

return new Promise((resolve,reject)=>{
    request(_options,(error, response, body)=>{
        ///XXXX
    ])
})复制代码

分析结果

首先, 来讲说什么是Content-Length,在http的协议中Content-Length首部告诉浏览器报文中实体主体的大小。这个大小是包含了内容编码的，好比对文件进行了gzip压缩，Content-Length就是压缩后的大小（这点对咱们编写服务器很是重要）。除非使用了分块编码，不然Content-Length首部就是带有实体主体的报文必须使用的。使用Content-Length首部是为了可以检测出服务器崩溃而致使的报文截尾，并对共享持久链接的多个报文进行正确分段.

其次,为何含有中文字符的请求参数返回400,由于Content-Length是计算请求参数的字节数,而非字符数.而JSON.stringify(param).length返回的是字符数.含中文字符的状况下

console.log('八阿哥'.length)  //3, 即3个字符复制代码

console.log(Buffer.byteLength('八阿哥', 'utf8'));  //9, utf-8编码下,一个汉字是3字节存储的复制代码

致使接口层拿到的Content-Length小于真实的字节长度, 于是没法正确的解析数据, 从而返回400 Bad Request.所以须要将设置Content-Length的长度改成Buffer.byteLength(JSON.stringify(param),'utf8')