Какая будет ошибка при выполнение не того метода в REST?

Ошибка при неправильном HTTP методе в REST API

В REST API очень важно использовать правильный HTTP метод. Если клиент отправляет запрос с неправильным методом, сервер должен вернуть соответствующую ошибку.

1. HTTP 405 Method Not Allowed

Самая правильная ошибка для этого случая — 405 Method Not Allowed:

@RestController
@RequestMapping("/api/v1/users")
public class UserController {
    
    @GetMapping("/{id}")
    public ResponseEntity<User> getUser(@PathVariable Long id) {
        return ResponseEntity.ok(userService.findById(id));
    }
    
    @PostMapping
    public ResponseEntity<User> createUser(@RequestBody User user) {
        return ResponseEntity.status(201).body(userService.save(user));
    }
}

// Если клиент отправит: DELETE /api/v1/users/1
// Сервер вернёт: 405 Method Not Allowed
// С заголовком: Allow: GET, POST

2. Другие возможные ошибки

404 Not Found — когда endpoint вообще не существует:

GET /api/v1/users/nonexistent → 404

400 Bad Request — когда метод правильный, но данные невалидны:

@PostMapping("/{id}")
public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
    // Это неправильно! DELETE должно быть
    userService.delete(id);
    return ResponseEntity.noContent().build();
}

// Если клиент отправит: POST /api/v1/users/1 (с пустым телом)
// Может быть 400 или 405 в зависимости от реализации

3. Основные HTTP методы и их назначение

// GET — получение ресурса (безопасен, идемпотентен)
@GetMapping("/{id}")
public ResponseEntity<User> getUser(@PathVariable Long id) { ... }

// POST — создание нового ресурса
@PostMapping
public ResponseEntity<User> createUser(@RequestBody User user) { ... }

// PUT — полное обновление существующего ресурса (идемпотентен)
@PutMapping("/{id}")
public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User user) { ... }

// PATCH — частичное обновление
@PatchMapping("/{id}")
public ResponseEntity<User> partialUpdate(@PathVariable Long id, @RequestBody Map<String, Object> updates) { ... }

// DELETE — удаление ресурса (идемпотентен)
@DeleteMapping("/{id}")
public ResponseEntity<Void> deleteUser(@PathVariable Long id) { ... }

// HEAD — как GET но без тела ответа
@RequestMapping(method = RequestMethod.HEAD, value = "/{id}")
public ResponseEntity<Void> headUser(@PathVariable Long id) { ... }

// OPTIONS — показывает доступные методы
@RequestMapping(method = RequestMethod.OPTIONS, value = "/{id}")
public ResponseEntity<Void> optionsUser() { ... }

4. Как правильно обработать 405 в Spring

@RestControllerAdvice
public class GlobalExceptionHandler {
    
    @ExceptionHandler(HttpRequestMethodNotSupportedException.class)
    public ResponseEntity<ErrorResponse> handleMethodNotAllowed(
            HttpRequestMethodNotSupportedException ex) {
        ErrorResponse error = new ErrorResponse();
        error.setStatus(405);
        error.setMessage("Method not allowed: " + ex.getMethod());
        error.setAllowedMethods(ex.getSupportedHttpMethods());
        return ResponseEntity.status(405).body(error);
    }
}

5. Таблица кодов ошибок

6. Пример полной обработки

@RestController
@RequestMapping("/api/v1/products")
public class ProductController {
    
    @GetMapping("/{id}")
    public ResponseEntity<Product> getProduct(@PathVariable Long id) {
        return ResponseEntity.ok(new Product(id, "Laptop"));
    }
    
    @PostMapping
    public ResponseEntity<Product> createProduct(@RequestBody Product product) {
        return ResponseEntity.status(201).body(product);
    }
    
    // DELETE /api/v1/products/1 → 204 No Content (успех)
    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteProduct(@PathVariable Long id) {
        return ResponseEntity.noContent().build();
    }
}

// Если клиент отправит: PATCH /api/v1/products/1
// А в контроллере нет @PatchMapping
// Spring вернёт: 405 Method Not Allowed
// С заголовком: Allow: GET, POST, DELETE

Итого

• 405 Method Not Allowed — правильная ошибка для неправильного HTTP метода
• Включай Allow заголовок — указывает доступные методы
• Соблюдай REST соглашения — GET/POST/PUT/PATCH/DELETE
• 404 != 405 — 404 это когда endpoint не существует, 405 это когда метод неправильный
• Обрабатывай gracefully — возвращай понятные ошибки с описанием