快捷導(dǎo)航

SpringBoot設(shè)置HTTP響應(yīng)狀態(tài)碼過(guò)程(HTTP Status Code)

更新時(shí)間：2026年01月06日 09:18:06 作者：小康師兄

本文介紹了HTTP響應(yīng)狀態(tài)碼的分類(lèi)及其在SpringBoot中的使用示例,狀態(tài)碼包括信息、成功、重定向、客戶(hù)端錯(cuò)誤和服務(wù)器錯(cuò)誤,常用的幾種狀態(tài)碼有200（請(qǐng)求成功）、400（客戶(hù)端錯(cuò)誤）、404（資源未找到）和500（服務(wù)器內(nèi)部錯(cuò)誤）

SpringBoot 設(shè)置HTTP 響應(yīng)狀態(tài)碼 (HTTP Status Code)

HTTP請(qǐng)求響應(yīng)的內(nèi)容有很多，包括Body、Cookies、Headers和Status。

我們最常用的是Body、其次Headers、Cookies。而HTTP Status Code關(guān)注得最少。

HTTP Status Code

分類(lèi)	分類(lèi)描述
1**	信息，服務(wù)器收到請(qǐng)求，需要請(qǐng)求者繼續(xù)執(zhí)行操作
2**	成功，操作被成功接收并處理
3**	重定向，需要進(jìn)一步的操作以完成請(qǐng)求
4**	客戶(hù)端錯(cuò)誤，請(qǐng)求包含語(yǔ)法錯(cuò)誤或無(wú)法完成請(qǐng)求
5**	服務(wù)器錯(cuò)誤，服務(wù)器在處理請(qǐng)求的過(guò)程中發(fā)生了錯(cuò)誤

常用的幾種狀態(tài)碼

狀態(tài)碼	英文名	中文描述
200	OK	請(qǐng)求成功。一般用于GET與POST請(qǐng)求
201	Created	已創(chuàng)建。成功請(qǐng)求并創(chuàng)建了新的資源
202	Accepted	已接受。已經(jīng)接受請(qǐng)求，但未處理完成
400	Bad Request	客戶(hù)端錯(cuò)誤，請(qǐng)求包含語(yǔ)法錯(cuò)誤或無(wú)法完成請(qǐng)求
401	Unauthorized	請(qǐng)求要求用戶(hù)的身份認(rèn)證
403	Forbidden	服務(wù)器理解請(qǐng)求客戶(hù)端的請(qǐng)求，但是拒絕執(zhí)行此請(qǐng)求
404	Not Found	服務(wù)器無(wú)法根據(jù)客戶(hù)端的請(qǐng)求找到資源（網(wǎng)頁(yè)）
500	Internal Server Error	服務(wù)器內(nèi)部錯(cuò)誤，無(wú)法完成請(qǐng)求
501	Not Implemented	服務(wù)器不支持請(qǐng)求的功能，無(wú)法完成請(qǐng)求
503	Service Unavailable	由于超載或系統(tǒng)維護(hù)，服務(wù)器暫時(shí)的無(wú)法處理客戶(hù)端的請(qǐng)求

SpringBoot示例

    @Log(title = "HTTP Status Code 測(cè)試", businessType = BusinessType.OTHER)
    @PostMapping("/test")
    public ResponseEntity<AjaxResult> auth(@RequestParam String username, @RequestParam String password)
    {
        switch (username){
            case "200":
                return ResponseEntity.ok().body(AjaxResult.success());
            case "400":
                return ResponseEntity.badRequest().body(AjaxResult.error(400,"Bad Request"));
            case "404":
                return ResponseEntity.notFound().build();
            case "500":
                return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(AjaxResult.error());
            default:
                return ResponseEntity.status(203).body(AjaxResult.success());
        }
    }