解決常見HTTP錯誤的最佳實踐 – Status 400

一、初識 HTTP 狀態碼

HTTP 狀態碼是客戶端向服務端請求後，服務端返回的標識請求狀態的三位數字。常見的狀態碼有 1xx，2xx，3xx，4xx，5xx 等。其中 4xx 系列代表客戶端發起了錯誤的請求，服務端無法處理。而其中 Status 400 代表的是伺服器無法理解客戶端的請求，原因可能是數據格式不正確或者缺少必要的請求參數。

在實際開發過程中，當我們遇到列印出 Status 400 的錯誤信息時，我們應該從何處入手排查問題呢？下面我們將從三個方面進行介紹和分析。

二、常見的 Status 400 錯誤原因

1. 參數傳遞錯誤：當客戶端傳遞的參數格式不正確或者缺少必要的參數時，就會導致 Status 400 的錯誤。

// 示例代碼
router.get('/example', (req, res) => {
  const {id} = req.query;
  if (!id) {
    res.status(400).send('id is required');
    return;
  }
  // ...
});

上面的代碼中，客戶端請求示例 URL 為 http://localhost:3000/example?id=123。如果客戶端沒有傳遞 id 參數，那麼伺服器就會返回 Status 400 的錯誤提示信息 “id is required”。

2. 數據格式不正確：當客戶端傳遞的數據格式與期望的格式不匹配時，也會導致 Status 400 的錯誤。

// 示例代碼
router.post('/example', (req, res) => {
  const {name, age} = req.body;
  if (!name || !age || typeof name !== 'string' || typeof age !== 'number') {
    res.status(400).send('name(string) and age(number) are required');
    return;
  }
  // ...
});

上面的代碼中，客戶端向伺服器提交了一個 POST 請求，包含了 name 和 age 兩個欄位。當客戶端提交的數據格式不是字元串和數字時，伺服器就會返回 Status 400 的錯誤提示信息 “name(string) and age(number) are required”。

3. 重複提交：在一些需要頻繁提交的場景中，如果客戶端提交的內容與上一次提交的內容一樣，那麼伺服器就可能返回 Status 400 的錯誤。

// 示例代碼
let prevData = null;

router.post('/example', (req, res) => {
  const data = req.body;
  if (JSON.stringify(data) === JSON.stringify(prevData)) {
    res.status(400).send('You have already submitted the same data');
    return;
  }
  prevData = data;
  // ...
});

上面的代碼中，如果客戶端連續多次提交相同的數據，伺服器就會返回 Status 400 的錯誤提示信息 “You have already submitted the same data”。

三、如何避免 Status 400 錯誤

1. 合法性校驗：對於客戶端傳遞的參數和數據格式，需要在伺服器端進行合法性校驗，確保傳遞的數據格式和參數符合要求，避免 Status 400 錯誤的發生。例如，可以使用各種第三方庫對參數合理性進行校驗，比如 Joi、express-validator 等。

2. 處理重複請求：在處理需要頻繁提交的場景中，可以設置一個請求間隔時間，確保客戶端在時間範圍內只能提交一次數據，避免 Status 400 錯誤的發生。

3. 返回合適的狀態碼：如果客戶端傳遞的數據格式不正確或者缺少必要的參數時，需要返回合適的 Status 400 錯誤碼，不能使用其他的錯誤碼。另外，錯誤提示信息需要簡潔明了、易於理解。

四、總結

在實際開發過程中，遇到 Status 400 的錯誤信息時，我們需要通過查看伺服器返回的錯誤提示信息，去分析出問題所在，從而判斷是參數傳遞錯誤、數據格式不正確還是重複提交問題，並採取相應的措施避免 Status 400 錯誤的再次發生。