Всегда ли ошибка 400 гарантирует что ошибка произошла на стороне клиента

Ошибка 400: всегда ли это ошибка клиента?

Ответ: Нет, ошибка 400 не гарантирует, что ошибка произошла на стороне клиента. Хотя по спецификации HTTP 400 Bad Request означает ошибку клиента, на практике это не всегда так.

Что означает 400 Bad Request

По спецификации HTTP, статус 400 Bad Request указывает, что:

• Сервер не может понять запрос из-за синтаксической ошибки
• Запрос имеет неправильный формат
• Запрос не соответствует ожидаемому формату

// Пример запроса, вызывающего 400
fetch("https://api.example.com/users", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    // Отсутствует необходимое поле email
    name: "Иван"
  })
})
.then(res => {
  if (!res.ok) {
    console.log("Ошибка:", res.status); // 400
  }
});

Когда сервер ошибочно возвращает 400

Иногда разработчики неправильно используют 400, когда на самом деле произошла ошибка на сервере:

1. Ошибка валидации на стороне сервера

// Клиент отправляет корректный запрос
fetch("https://api.example.com/users", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "Иван",
    email: "ivan@example.com",
    age: 30
  })
})
.then(res => res.json())
.then(data => {
  // Сервер вернул 400 из-за ошибки валидации
  // "Возраст не может быть больше 25"
  // Но это ошибка бизнес-логики на сервере, не клиента!
});

2. Неправильная обработка исключений

// На сервере (express.js пример)
app.post("/api/users", (req, res) => {
  try {
    const user = JSON.parse(req.body);
    
    // Ошибка в коде сервера
    const result = someFunction(user);
    
    res.json(result);
  } catch (error) {
    // Неправильно: сервер ловит ошибку и возвращает 400
    res.status(400).json({ error: error.message });
    // Это может быть ошибка 500, так как проблема на сервере!
  }
});

3. Неправильная логика на сервере

// На сервере
app.post("/api/transfer", (req, res) => {
  const { from, to, amount } = req.body;
  
  // Клиент отправил корректный запрос
  if (!from || !to || !amount) {
    return res.status(400).json({ error: "Missing fields" });
  }
  
  try {
    // Ошибка при обращении к базе данных
    const account = await database.getAccount(from);
    // ... остальной код ...
  } catch (error) {
    // Неправильно: возвращаем 400 вместо 500
    return res.status(400).json({ error: "Invalid request" });
  }
});

Правильные HTTP статусы для разных ошибок

// На сервере с правильным использованием статусов

app.post("/api/users", async (req, res) => {
  try {
    const { name, email } = req.body;
    
    // 400 - ошибка клиента: отсутствует необходимое поле
    if (!name || !email) {
      return res.status(400).json({ error: "Name and email are required" });
    }
    
    // 400 - ошибка клиента: неверный формат email
    if (!isValidEmail(email)) {
      return res.status(400).json({ error: "Invalid email format" });
    }
    
    // 409 - конфликт: пользователь с этим email уже существует
    const existingUser = await User.findOne({ email });
    if (existingUser) {
      return res.status(409).json({ error: "User already exists" });
    }
    
    // 201 - успешное создание
    const user = await User.create({ name, email });
    res.status(201).json(user);
    
  } catch (error) {
    // 500 - ошибка сервера: не ожидаемая ошибка
    console.error(error);
    return res.status(500).json({ error: "Internal server error" });
  }
});

Как клиенту правильно обработать ошибки

async function fetchUsers() {
  try {
    const response = await fetch("https://api.example.com/users", {
      method: "GET"
    });
    
    // Проверяем разные статусы
    if (response.status === 400) {
      // Ошибка клиента: неверный запрос
      const error = await response.json();
      console.error("Invalid request:", error.message);
      // Показываем ошибку пользователю
      showErrorToUser(error.message);
      
    } else if (response.status === 401) {
      // Ошибка клиента: не авторизирован
      console.error("Unauthorized");
      redirectToLogin();
      
    } else if (response.status === 403) {
      // Ошибка клиента: нет доступа
      console.error("Forbidden");
      showErrorToUser("У вас нет доступа");
      
    } else if (response.status === 404) {
      // Ошибка клиента: ресурс не найден
      console.error("Not found");
      showErrorToUser("Ресурс не найден");
      
    } else if (response.status >= 500) {
      // Ошибка сервера: внутренняя ошибка
      console.error("Server error");
      showErrorToUser("Ошибка на сервере. Попробуйте позже");
      
    } else if (response.ok) {
      // Успех
      return await response.json();
    }
  } catch (error) {
    // Сетевая ошибка или ошибка парсинга
    console.error("Network error:", error);
    showErrorToUser("Ошибка сети");
  }
}

Реальные примеры неправильного использования 400

Пример 1: Ошибка в бизнес-логике

// Клиент отправляет корректный JSON
fetch("https://api.example.com/withdraw", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    accountId: "12345",
    amount: 1000
  })
});

// Сервер возвращает 400
// { error: "Insufficient funds" }

// Это неправильно! 400 означает синтаксическую ошибку,
// а здесь ошибка бизнес-логики.
// Правильный статус: 422 Unprocessable Entity или 402 Payment Required

Пример 2: Ошибка при обращении к базе

// На сервере
app.get("/api/users/:id", async (req, res) => {
  try {
    const userId = req.params.id;
    
    // Если ID не правильный UUID
    if (!isValidUUID(userId)) {
      return res.status(400).json({ error: "Invalid user ID format" });
    }
    
    // Правильно: 400
    const user = await User.findById(userId);
    
    // Но если произойдёт ошибка базы:
    // connection.query() -> Error
    // Нельзя возвращать 400!
    
  } catch (error) {
    // 500 - ошибка сервера
    res.status(500).json({ error: "Database error" });
  }
});

Правильная классификация статусов

4xx статусы (ошибка клиента):

• 400 Bad Request - синтаксическая ошибка запроса
• 401 Unauthorized - требуется аутентификация
• 403 Forbidden - доступ запрещен
• 404 Not Found - ресурс не найден
• 409 Conflict - конфликт (дублирование)
• 422 Unprocessable Entity - ошибка валидации данных
• 429 Too Many Requests - слишком много запросов

5xx статусы (ошибка сервера):

• 500 Internal Server Error - внутренняя ошибка
• 502 Bad Gateway - ошибка шлюза
• 503 Service Unavailable - сервис недоступен
• 504 Gateway Timeout - превышено время ожидания

Итог

Ошибка 400 не всегда гарантирует ошибку клиента. На практике:

1. Правильный 400 - когда запрос синтаксически неверен
2. Неправильный 400 - когда сервер ошибочно его возвращает вместо 500
3. Клиент должен анализировать не только статус, но и тело ответа
4. Сервер должен правильно классифицировать ошибки

Когда видите 400, проверьте:

• Действительно ли отправили корректные данные?
• Может ли сервер быть источником ошибки?
• Какой текст ошибки вернул сервер?

Управление HTTP статусами - это критичная часть правильного API дизайна.