HTTP接口报错详解与解决 200,500,403,408,404

前言：

仅做学习记录，侵删

背景

当后端编写接口时，经常需要对接口使用ApiFox或者PostMan进行测试，此时就会出现各种各样的报错，一般都会包括报错编码：200,400,401等。这个状态码一般是服务器所返回的包含http状态码的信息头（server header）用以响应请求。

程序员最想看到的：200-OK。

程序员不想看到的：500-Internal-Server-Error。

用户不想看到的：401-Unauthorized、403-Forbidden、408-Request-Time-out、404-not-found。

常见的Http状态码

HTTP状态码组成

一般情况下由HTTP 状态码由三个十进制数字组成，第一个十进制数字定义了状态码的类型。

HTTP状态码分类

一般情况下响应分为五类：

1. 信息响应(100--199)
2. 成功响应(200--299)
3. 重定向(300--399)
4. 客户端错误(400--499)
5. 服务器错误 (500--599)

|--------|-------------------------|
| 分类 | 分类描述 |
| 1** | 信息，服务器收到请求，需要请求者继续执行操作 |
| 2** | 成功，操作被成功接收并处理 |
| 3** | 重定向，需要进一步的操作以完成请求 |
| 4** | 客户端错误，请求包含语法错误或无法完成请求 |
| 5** | 服务器错误，服务器在处理请求的过程中发生了错误 |

HTTP状态码列表

📌备注： 如果你收到的响应不在此列表中，则它为非标准响应，可能是服务器软件的自定义响应。

信息响应(100--199)

成功响应(200--299)

重定向消息(300--399)

|---------|---------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 状态码 | 状态码英文名称 | 中文描述 |
| 300 | Multiple Choices | 多种选择。请求的资源可包括多个位置，相应可返回一个资源特征与地址的列表用于用户终端（例如：浏览器）选择 |
| 301 | Moved Permanently | 永久移动。请求的资源已被永久的移动到新URI，返回信息会包括新的URI，浏览器会自动定向到新URI。今后任何新的请求都应使用新的URI代替 |
| 302 | Found | 临时移动。与301类似。但资源只是临时被移动。客户端应继续使用原有URI |
| 303 | See Other | 查看其它地址。与301类似。使用GET和POST请求查看 |
| 304 | Not Modified | 未修改。所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。客户端通常会缓存访问过的资源，通过提供一个头信息指出客户端希望只返回在指定日期之后修改的资源 |
| 305 | Use Proxy | 使用代理。所请求的资源必须通过代理访问 |
| 306 | Unused | 已经被废弃的HTTP状态码 |
| 307 | Temporary Redirect | 临时重定向。与302类似。使用GET请求重定向 |
| 308 | Permanent Redirect | 这意味着资源现在永久位于由Location: HTTP Response 标头指定的另一个 URI。这与 301 Moved Permanently HTTP 响应代码具有相同的语义，但用户代理不能更改所使用的 HTTP 方法：如果在第一个请求中使用 POST，则必须在第二个请求中使用 POST。 |

客户端错误(400--499)

|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 状态码 | 状态码英文名称 | 中文描述 |
| 400 | Bad Request | 客户端请求的语法错误，服务器无法理解 |
| 401 | Unauthorized | 请求要求用户的身份认证 |
| 402 | Payment Required | 保留，将来使用 |
| 403 | Forbidden | 服务器理解请求客户端的请求，但是拒绝执行此请求 |
| 404 | Not Found | 服务器无法根据客户端的请求找到资源（网页）。通过此代码，网站设计人员可设置"您所请求的资源无法找到"的个性页面 |
| 405 | Method Not Allowed | 客户端请求中的方法被禁止 |
| 406 | Not Acceptable | 服务器无法根据客户端请求的内容特性完成请求 |
| 407 | Proxy Authentication Required | 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权 |
| 408 | Request Time-out | 服务器等待客户端发送的请求时间过长，超时 |
| 409 | Conflict | 服务器完成客户端的 PUT 请求时可能返回此代码，服务器处理请求时发生了冲突 |
| 410 | Gone | 客户端请求的资源已经不存在。410不同于404，如果资源以前有现在被永久删除了可使用410代码，网站设计人员可通过301代码指定资源的新位置 |
| 411 | Length Required | 服务器无法处理客户端发送的不带Content-Length的请求信息 |
| 412 | Precondition Failed | 客户端请求信息的先决条件错误 |
| 413 | Request Entity Too Large | 由于请求的实体过大，服务器无法处理，因此拒绝请求。为防止客户端的连续请求，服务器可能会关闭连接。如果只是服务器暂时无法处理，则会包含一个Retry-After的响应信息 |
| 414 | Request-URI Too Large | 请求的URI过长（URI通常为网址），服务器无法处理 |
| 415 | Unsupported Media Type | 服务器无法处理请求附带的媒体格式 |
| 416 | Requested range not satisfiable | 客户端请求的范围无效 |
| 417 | Expectation Failed（预期失败） | 服务器无法满足请求头中 Expect 字段指定的预期行为。 |
| 418 | I'm a teapot | 状态码 418 实际上是一个愚人节玩笑。它在 RFC 2324 中定义，该 RFC 是一个关于超文本咖啡壶控制协议（HTCPCP）的笑话文件。在这个笑话中，418 状态码是作为一个玩笑加入到 HTTP 协议中的。服务端拒绝用茶壶煮咖啡。笑话，典故来源茶壶冲泡咖啡 |
| 421 | Misdirected Request | 请求被定向到一个无法生成响应的服务器。如果连接被重复使用或选择了其他服务，就有可能出现这种情况。 |
| 422 | Unprocessable Entity (WebDAV) | 服务器理解请求实体的内容类型，并且请求实体的语法是正确的，但是服务器无法处理所包含的指令。 |
| 423 | Locked (WebDAV) | 暂定目标资源被锁定，即无法访问。其内容应包含一些 WebDAV XML 格式的信息。 |
| 424 | Failed Dependency (WebDAV) | 由于请求的操作依赖于另一个操作，且该操作失败，因此无法在资源上执行该方法。普通 web 服务器通常不会返回此状态代码。但其他一些协议，如 WebDAV 可以返回该状态代码。例如，在 WebDAV 中，如果发出了 PROPPATCH 请求，其中一条命令失败，那么其他命令也会自动以 424 Failed Dependency 的形式失败。 |
| 425 | Too Early 实验性 | 代表服务器不愿意冒风险来处理该请求，原因是处理该请求可能会被"重放"，从而造成潜在的重放攻击。 |
| 426 | Upgrade Required | 服务器拒绝使用当前协议执行请求，但在客户端升级到其他协议后可能愿意这样做。服务端发送带有Upgrade 字段的 426 响应来表明它所需的协议（们）。 |
| 428 | Precondition Required | 源服务器要求请求是有条件的。此响应旨在防止'丢失更新'问题，即当第三方修改服务器上的状态时，客户端 GET 获取资源的状态，对其进行修改并将其 PUT 放回服务器，从而导致冲突。 |
| 429 | Too Many Requests | 用户在给定的时间内发送了太多请求（"限制请求速率"） |
| 431 | Request Header Fields Too Large | 服务器不愿意处理请求，因为其头字段太大。在减小请求头字段的大小后，可以重新提交请求。 |
| 451 | Unavailable For Legal Reasons | 用户代理请求了无法合法提供的资源，例如政府审查的网页。 |

服务器错误 (500--599)

常见的HTTP状态码出错解决

HTTP 400 错误

🚫警告： 客户端不应该在未进行修改的情况下重复发送此请求。

说明

当状态码为400时，主要有两种形式：

1、bad request 意思是 "错误的请求"；
2、invalid hostname 意思是 "不存在的域名"。

由上述列表，400 Bad Request 是由于明显的客户端错误（例如，格式错误的请求语法，太大的大小，无效的请求消息或欺骗性路由请求），服务器不能或不会处理该请求。

原因

在 ajax 请求后台数据时比较常见。产生 HTTP 400 错误的原因有：

1、前端提交数据的字段名称或者是字段类型和后台的实体类不一致，导致无法封装；
2、前端提交的到后台的数据应该是 json 字符串类型，而前端没有将对象转化为字符串类型；

解决方案：

1、对照字段名称，类型保证一致性
2、使用 stringify 将前端传递的对象转化为字符串：

data: JSON.stringify(param);

常见情况

传参错误

传null值给一个非空字段

数据格式错误，比如传一个JSON格式的数据给String类型

404 NOT FOUND！

说明

404页面是网站必备的一个页面，它承载着用户体验与SEO优化的重任。如果站长没有设置404页面，会出现死链接，蜘蛛爬行这类网址时，不利于搜索引擎收录。

原因

404页面通常为用户访问了网站上不存在或已删除的页面，服务器返回的404错误。

404 Not Found 由来

据说在第三次科技革命之前，互联网的形态就是一个大型的中央数据库，这个数据库就设置在404房间里面。那时候所有的请求都是由人工手动完成的，如果在数据库中没有找到请求者所需要的文件，或者由于请求者写错了文件编号，用户就会得到一个返回信息：room 404 : file not found。后来互联网兴起后，人们也就习惯了用404作为服务器未找到文件的错误代码了。当然实际考证传说中的room 404是不存在的。

设置404页面的两大好处

引导用户不要关闭网站，增强用户体验。
防止网站出现死链接。

常见情况

请求的接口路径错误，比如实际接口路径为tblTeacher/getTeacherName，但却写成了tblTeacher/getTeacher

500 Internal Server Error

说明

在 HTTP 协议中，500 Internal Server Error 是表示服务器端错误的响应状态码，意味着所请求的服务器遇到意外的情况并阻止其执行请求。

这个错误代码是一个通用的"万能"响应代码。有时候，对于类似于 500 这样的错误，服务器管理员会更加详细地记录相关的请求信息来防止以后同样错误的出现。

一般情况下为代码逻辑错误，请检查编辑器后台服务日志。

原因

这种报错原因比较多，一般情况下都会有后台报错日志显示具体的报错原因和位置，可以根据后台所产生的具体报错原因去搜索对应的解决办法。一般情况下为代码逻辑错误，比如产生空指针异常等。

解决方案

检查服务器日志：查看服务器的日志文件，以获取更详细的错误信息。服务器日志通常记录了发生错误的原因和具体的错误消息。根据日志信息，尝试定位和解决问题。
检查服务器端代码：如果你有权限访问服务器端的代码，仔细检查服务器端的代码逻辑，确认没有错误或异常情况。确保代码没有bug，并且能够正确地处理请求。
检查服务器配置：检查服务器的配置文件，确保配置正确。可能是某个配置项的值不正确，导致服务器无法正常运行。根据服务器的类型和使用的软件，检查相关的配置文件，并进行必要的修改。
重启服务器：尝试重启服务器，以解决可能由于服务器进程或服务异常导致的问题。重启服务器可以清除临时的错误状态，并重新启动服务器进程。

HTTP接口报错详解与解决 200,500,403,408,404

前言：

背景

常见的Http状态码

HTTP状态码组成

HTTP状态码分类

HTTP状态码列表

信息响应(100--199)

成功响应(200--299)

重定向消息(300--399)

客户端错误(400--499)

服务器错误 (500--599)

常见的HTTP状态码出错解决

HTTP 400 错误

说明

原因

解决方案：

常见情况

传参错误

传null值给一个非空字段

数据格式错误，比如传一个JSON格式的数据给String类型

404 NOT FOUND！

说明

原因

404 Not Found 由来

设置404页面的两大好处

常见情况

请求的接口路径错误，比如实际接口路径为tblTeacher/getTeacherName，但却写成了tblTeacher/getTeacher

500 Internal Server Error

说明

原因

解决方案

参考资料