HTTP 409 Conflict
Código de estado 409 · Clase 4xx
Mensaje oficial (tal como aparece en pantalla): Conflict
También se busca como: error 409, HTTP 409, 409 conflict
Qué significa
La solicitud no pudo completarse porque entra en conflicto con el estado actual del recurso. Las API devuelven 409 cuando intentas crear algo que ya existe, actualizar un registro que otra persona modificó o realizar una acción no permitida en el estado actual.
Se aplica a: API REST, WebDAV, API de alojamiento Git
Cómo solucionar HTTP 409 Conflict
- Actualiza los datos y reintenta el cambio a partir de la versión más reciente
- Lee el cuerpo de la respuesta; las API bien diseñadas explican qué campo o versión entra en conflicto
- Si estás creando un recurso, comprueba si ya existe (nombre de usuario, correo o ID duplicados)
- Si la API usa ETags, envía el valor actual en 'If-Match' y reintenta tras obtener la copia más reciente
- En clientes de sincronización de archivos o WebDAV, resuelve manualmente la copia en conflicto
- Si eres el propietario de la API: devuelve un mensaje de error claro y la versión actual del recurso para que los clientes puedan recuperarse
Por qué ocurre
La RFC 9110 usa 409 para los conflictos con el estado actual del recurso de destino, normalmente ediciones simultáneas, restricciones de unicidad y transiciones de estado no válidas.
Preguntas frecuentes
¿409 es un error del servidor?
No. Es un código 4xx del lado del cliente: la solicitud es válida, pero choca con datos existentes y hay que modificarla o reintentarla.
Errores relacionados
Fuente: IANA HTTP Status Code Registry · soluciones redactadas y revisadas por los editores (consulta nuestra política editorial)
Última actualización: