HTTP 409 Conflicto de estado
409 Conflict significa que la solicitud no puede completarse porque contradice el estado actual del recurso.
Significado
409 es habitual en API al crear un usuario con un correo que ya existe, actualizar un registro modificado por otra persona o hacer un Git push a una rama que ha cambiado. La respuesta debería explicar el conflicto para poder solucionarlo.
Causas habituales
- Ya existe otro recurso con la misma clave única.
- Varias personas editan a la vez el mismo registro (bloqueo optimista).
- Se intenta una transición de estado no válida, como cancelar un pedido ya enviado.
- La versión de un archivo u objeto no coincide con la que esperaba el cliente.
¿Qué puede hacer un visitante?
- Actualiza la página para recuperar el estado más reciente y vuelve a intentarlo tras revisar los cambios.
- Si el registro de una cuenta devuelve 409, puede que ya exista una cuenta con esos datos.
¿Qué puede hacer el administrador?
- Explica claramente en la respuesta API qué entra en conflicto y cómo resolverlo.
- Para cambios simultáneos utiliza ETag e If-Match, que también pueden devolver 412.
- No uses 409 para errores generales de validación, donde corresponde 400 o 422.
Impacto en SEO
Los códigos 409 suelen aparecer en API y formularios, no en páginas públicas, y por tanto normalmente no afectan a su SEO.
Preguntas frecuentes
¿HTTP 409 significa que el servidor falla?
No. El servidor funciona, pero la solicitud contradice el estado actual del recurso y no puede aplicarla.
¿Cómo solucionar un error 409 de API?
Consulta el estado más reciente del recurso, reconcilia tus cambios y envía otra petición compatible.