HTTP 501 Not Implemented

Qué significa HTTP 501

HTTP 501 Not Implemented significa que el servidor no reconoce ni soporta la funcionalidad necesaria para cumplir la solicitud. La especificación lo reserva principalmente para métodos HTTP no reconocidos — el servidor no puede manejar el verbo para ningún recurso, a diferencia de 405, donde el verbo es conocido pero no está permitido para esa URL.

En la práctica, 501 también aparece en proxies y servidores antiguos que reciben solicitudes para las que nunca fueron construidos (verbos WebDAV, PATCH en stacks antiguos), o como marcador de posición en backends a medio configurar.

Causas comunes de los errores 501

• Un método HTTP que el servidor no implementa en absoluto (por ejemplo, PATCH o verbos WebDAV en un servidor antiguo).
• Un proxy o gateway que recibe un método de solicitud que no puede reenviar.
• Un endpoint provisional desplegado antes de terminar su implementación.
• Nombres de método malformados por clientes con errores (typos como GETT).

Cómo solucionarlo como desarrollador

• Comprueba el método exacto que se envía — los typos y los verbos personalizados con mayúsculas incorrectas son sorprendentemente comunes.
• Si el método es legítimo (por ejemplo, PATCH), actualiza o configura el servidor/framework para soportarlo, o túnelízalo vía POST con una cabecera de override donde el stack lo permita.
• Distíngelo de 405: si solo una ruta rechaza el verbo, arregla la ruta (terreno de 405); si lo hace todo el servidor, es una carencia de capacidad de la plataforma.
• No devuelvas 501 para funcionalidades sin terminar en APIs de producción — prefiere 404 o un feature flag, ya que 501 es cacheable por defecto.

Ejemplo de respuesta

HTTP/1.1 501 Not Implemented
Content-Type: application/json

{"error":"not_implemented","message":"PATCH is not supported by this server"}

Preguntas frecuentes