常见HTTP错误码模拟

最近发现部分同学虽然知道HTTP错误码，但对产生的具体原因并不清楚，所以我打算对比较常见的错误码进行模拟，帮助大家理解。

环境搭建

首先我们先搭建一个用于模拟的环境，公司架构一般分为负载均衡层和服务层，负载均衡我们使用nginx，服务使用Go。

Go

本次使用Go代码，所有代码位于：https://github.com/shidawuhen/asap/blob/master/controller/various/httpcode.go

服务监听端口为：8082

访问：http://127.0.0.1:8082/ping 可看到返回

Nginx

安装

Mac下安装Nginx命令：brew install nginx

Nginx安装位置为：/usr/local/etc/nginx

启动

命令行执行：nginx。没有报错表示执行成功。

访问

http://localhost:8080/

配置

修改Nginx的config文件，将请求代理到Go服务。

location / {       #请求的url过滤，正则匹配，~为区分大小写，~*为不区分大小写。proxy_pass  http://127.0.0.1:8082;  #请求转向mysvr 定义的服务器列表proxy_set_header Host $host;proxy_set_header Connection "";   #设置Connection为长连接（默认为no）proxy_connect_timeout 30;         #与upstream server的连接超时时间proxy_read_timeout 60s;           #nginx会等待多长时间来获得请求的响应proxy_send_timeout 12s;           #发送请求给upstream服务器的超时时间proxy_http_version 1.1;}

Nginx加载新的配置：nginx -s reload

请求ping，可看到请求转发到Go服务。

200-OK

我们先看一下正常情况。

请求

http://localhost:8080/httpcode/code200

代码

对应的Go代码为：

func Code200(c *gin.Context) {c.String(http.StatusOK, "ok")
}

500-Internal Server Error

说明

500 （服务器内部错误）：服务器遇到错误，无法完成请求。

内部服务错误：服务器遭遇到了一个预料之外的情况，这个情况阻止了它完成请求的处理。一般是语法错误或者服务panic。

请求

http://localhost:8080/httpcode/code500

代码

func Code500(c *gin.Context) {panic("1")c.String(http.StatusOK, "ok")
}

原因

主要是因为Gin里使用了默认Recover中间件，panic后将状态设置为500

func Default() *Engine {debugPrintWARNINGDefault()engine := New()engine.Use(Logger(), Recovery())return engine
}func defaultHandleRecovery(c *Context, err interface{}) {c.AbortWithStatus(http.StatusInternalServerError)
}

504-Gateway Time-out

说明

504 （网关超时）: 服务器作为网关或代理，但是没有及时从上游服务器收到请求。

网关超时：服务器，当作为一个网关或代理工作时，没有从上游服务器接收到为了完成请求所需访问的及时的响应(数据)。也就是说，nginx作为网关，为了完成请求，它必须获取到上游服务器的数据，但是上游服务器在规定时间内没有给到这些数据，所以nginx无法access到这些数据。也就是上游服务器响应超时了。

网关收到请求后，要调用其它服务器完成工作，其它服务器是上游服务器。

请求

http://localhost:8080/httpcode/code504

代码

func Code504(c *gin.Context) {time.Sleep(time.Second * 100)c.String(http.StatusOK, "ok")
}

原因

Nginx配置的超时时间为60s，但Go服务在100s后才能响应，所以60s后，Nginx没有收到响应，就直接返回504。

502-Bad Gateway

说明

502 （错误网关）：服务器作为网关或代理，从上游服务器收到无效响应。

网关错误：服务器，当它作为一个网关或者代理去工作，尝试着处理请求时，它从它所进入的到达的上游服务器处，接收到了一个非法、无效的响应。

所谓的非法、无效，是指预期之外的响应。

请求

http://localhost:8080/httpcode/code502

代码

Go服务down掉

对于这种情况，Nginx直接返回502。

Go主动关闭连接

方案一：新起服务

这个操作需要服务端收到请求后，立即将conn Close掉：

package mainimport ("fmt""net"
)func main() {ln, err := net.Listen("tcp", "127.0.0.1:8082")if err != nil {return}go func() {for {c, err := ln.Accept()fmt.Println("Accept")if err != nil {break}c.Close()}}()select {}
}

方案二：调整writetimeout

main函数中不使用run，使用自己构建的server，并设置WriteTimeout为1s。

//r.Run(":8082")
server := http.Server{Addr:         ":8082",WriteTimeout: time.Second * 1,ReadTimeout:  time.Second * 10,IdleTimeout:  time.Second * 10,Handler:      r,
}server.ListenAndServe()

同时让函数休眠2s。

func Code502(c *gin.Context) {//方案二time.Sleep(time.Second * 2)c.String(http.StatusOK, "ok")
}

503-Service Unavailable

说明

503 （服务不可用）：服务器目前无法使用（由于超载或停机维护）。通常，这只是暂时状态。

一般来说，出现503错误多半是因为网站访问量大，造成了流量超限或者并发数大引起的资源超限出现的错误。

模拟这种情况，需要改很多系统参数，风险较大，本次不做模拟。如果大家有别的模拟方法，可以告诉我。

499-CLIENT CLOSED REQUEST

说明

499（客户端关闭请求）：一个被nginx引入的非标准状态码，对应的场景是，当nginx正在处理请求时，客户端关闭了HTTP连接。

引申出来，就是当HTTP请求到达Nginx后，该请求还在被处理的状态时，浏览器的请求超时时间到了，主动关闭了连接。但是，此状态码在浏览器请求时几乎不可见，因为浏览器默认的超时时间会很长。多见于服务之间的调用，在业务架构中常常会分层设计，拆分为不同的子系统或者微服务，这样系统之间就会常常通过http方式来请求，并且会设置每次请求的超时时间，当请求在请求时间内所调用的上游服务无返回，则会主动关闭连接，上游服务日志中会记录一条499。

请求

因为浏览器超时时间较长，所以使用curl命令，设置三秒超时：

curl -i -m 3 http://127.0.0.1:8080/httpcode/code499

代码

func Code499(c *gin.Context) {time.Sleep(time.Second * 100)c.String(http.StatusOK, "ok")
}

通过nginx -V查看Nginx日志位置，找到access.log：

127.0.0.1 - - [28/Nov/2021:23:13:09 +0800] "GET /httpcode/code499 HTTP/1.1" 499 0 "-" "curl/7.64.1"

总结

虽然这次模拟了各种情况，但更加详细的原因在Nginx源码和Go源码中，大家有兴趣的话可以深入了解。

另外，在模拟过程中，使用的例子只是导致出现对应状态码的其中一些原因，还有其它的一些原因，大家可以寻找。

在模拟的过程中，自己也发现了很多新的知识点，还是很有趣的。

资料

常见HTTP错误代码大全
http 5**系列状态码详解
HTTP状态码 499 / 500 / 502 / 504
Golang之HTTP server 502问题分析
Gin设置Timeout
HTTP CODE 状态码500|502|504分析
mac下安装nginx
Golang之HTTP server 502问题分析
记录一次线上502排查过程
Golang 优化之路——HTTP长连接
客户端主动断开连接_Go实现客户端和服务器抓包分析TCP三次握手和断开操作
服务端主动终止连接的情况分析
Gin IdleTimeout本地验证
Nginx 503错误总结
低配终端环境下如何模拟大规模负载

最后

大家如果喜欢我的文章，可以关注我的公众号（程序员麻辣烫）

我的个人博客为：https://shidawuhen.github.io/

往期文章回顾：

设计模式
招聘
思考
存储
算法系列
读书笔记
小工具
架构
网络
Go语言