状态码
TIP
示例均为koa代码
const Koa = require('koa')
const app = new Koa()300
表示有多个版本供客户端选择,一般返回一个html页面供客户端选择。服务端也可以指定 location 头部,提供最优选择,但在 chrome上,并没有对这个 location 有任何响应。
app.use(async ctx => {
ctx.response.status = 300,
ctx.response.set('location', 'https://www.baidu.com/')
ctx.response.body = '<a href="https://www.baidu.com">baidu</a></br><a href="https://www.m.baidu.com">m.baidu</a>'
});301
永久重定向,浏览器会缓存要重定向的 location,并且搜索引擎也会对资源的链接进行更新。 当 location 变化时需要清理缓存,才能定位到新的 location
app.use(async ctx => {
ctx.response.status = 301,
ctx.response.set('location', 'https://www.baidu.com/')
});
app.listen('8000', '127.0.0.1')如上当将新的 location 改为 https://www.baidu.com/时,要清除 127.0.0.1:8000的缓存
302
暂时重定向,搜索引擎不会对资源的链接进行更新。也不会缓存,每次都会根据 location 进行重定向
app.use(async ctx => {
ctx.response.status = 302,
ctx.response.set('location', 'https://douban.com/')
});
app.listen('8000', '127.0.0.1')如上当 location 变化时会重定向到新的链接,不用清除缓存。
303
see other,通常是 put, post提交完数据要跳转的页面(由 location 指定)。不常用,一般由 javascript 进行跳转
app.use(async ctx => {
ctx.response.status = 303,
ctx.response.set('location', 'https://douban.com/')
});304
not modified,表示资源未修改。客户端与服务端协商缓存时,服务端用此来表示客户端缓存的内容未修改
app.use(async ctx => {
let stat = fs.statSync(path.resolve(__dirname, './index.html'))
let modifySince = ctx.request.header['if-modified-since']
if(!modifySince || new Date(modifySince).getTime() < new Date(stat.mtime).setMilliseconds(0)) {
ctx.response.status = 200
let data = fs.createReadStream(path.resolve(__dirname, './index.html'))
ctx.response.set('last-modified', new Date(new Date(stat.mtime).setMilliseconds(0)))
ctx.response.set('content-type', 'text/html')
ctx.body = data
} else {
ctx.response.status = 304
}
});上例为 last-modified 协商缓存,首次请求,服务端在请求头部中未接受到 if-modified-since,响应的状态码为 200,并在响应头部添加 last-modified,值为文件最新的修改时间,客户端缓存响应的内容,并在接下来的请求中把 last-modified 对应的值添加到 if-modified-since 头部中,服务端拿到 if-modified-since 的值之后,会和文件最新的修改时间作比较,如果相等,表示客户端缓存的是最新版本,返回 304 状态码。
TIP
可以看出, last-modified 只能精确到秒,在实践一般和其他缓存策略共同使用
305
Use Proxy,用来说明必须通过一个代理来访问资源;代理的位置由Location首部给出。
307
暂时重定向(1.1版本),与 302 的区别是保证重定向后的主体和方法不会改变。
308
永久重定向(1.1版本),与 301 的区别是保证重定向后的主体和方法不会改变。
400
Bad Request, 客户端请求语法错误,经常用来表示客户端请求的参数错误(成员及数据类型)。
401
Unauthorized,质询与应答的客户端验证方案。当服务端未收到凭证时返回 401 状态码,并在 WWW-Authenticate 首部提供如何进行验证的信息,客户端在 Authorization 请求头部中提供身份验证凭证。
402
Payment Required
TIP
本小节其余部分只有付费用户才能阅读
403
Forbidden,指的是服务器端有能力处理该请求,但是拒绝授权访问。与 401 的区别是没有验证的步骤
404
Not Found,代表客户端错误,指的是服务器端无法找到所请求的资源。
405
Method Not Allowed,返回头部因该包含 allow 头部表明服务器支持的方法
406
Not Acceptable,内容协商错误,服务端没有客户端所要求的资源版本
407
Proxy Authentication Required,与 403 类似,质询与应答的代理验证方案。当服务端未收到凭证时返回 407 状态码,并在 proxy-Authenticate 首部提供如何进行验证的信息,代理在 proxy-Authorization 请求头部中提供身份验证凭证。
408
Request Timeout,如果客户端完成请求所花的时间太长,服务器可以返回此状态码,并关闭连接。超时时间是可配置的。
409
Conflict,服务器担心请求会引发冲突时,可以发送此状态码。响应中应该包含描述冲突的主体。冲突最有可能发生在对 PUT 请求的响应中。例如,当上传文件的版本比服务器上已存在的要旧,从而导致版本冲突的时候,那么就有可能收到状态码为 409 的响应。
410
Gone,说明请求的目标资源在原服务器上不存在了,并且是永久性的丢失,主要用于Web站点的维护。
411
Length Required,客户端错误,客户端需要发送 content-length
412
Precondition Failed,表示客户端错误, 当资源在未修改的情况下,服务器返回请求的资源,当服务器判断资源已经修改则会返回 412。通常是 If-Unmodified-Since 或 If-None-Match 先决条件不成立时。
413
Request Entity Too Large
414
Request URI Too Long
415
Unsupported Media Type,表示服务器由于不支持其有效载荷的格式,从而拒绝接受客户端的请求。
416
Requested Range NotSatisfiable,服务器无法处理所请求的数据区间。
Expectation Failed,客户端错误,意味着服务器无法满足 Expect 请求消息头中的期望条件。
500
Internal Server Error,服务器内部逻辑出现错误
501
Not Implemented,服务器错误响应码表示请求的方法不被服务器支持,经常用到服务器开发过程中。 而 405 表示是客户端所用的方法有误,
502
Bad Gateway,它表示作为网关或代理角色的服务器,从上游服务器(如tomcat、php-fpm)中接收到的响应是无效的。通常用来表示网关不能理解其请求的内容
503
Service Unavailable,它表示服务器尚未处于可以接受请求的状态。通常造成这种情况的原因是由于服务器停机维护或者已超载。注意在发送该响应的时候,应该同时发送一个对用户友好的页面来解释问题发生的原因。该种响应应该用于临时状况下,与之同时,在可行的情况下,应该在 Retry-After 首部字段中包含服务恢复的预期时间。
504
Gateway Timeout, 与状态码408类似,只是这里的响应来自一个网关或代理,它们在等待另一服务器对其请求进行响应时超时了。
505
HTTP Version Not Supported,服务器收到的请求使用了它无法或不愿支持的协议版本时,使用此状态码。有些服务器应用程序会选择不支持协议的早期版本
