- Software y sistemas
- Servicio HTTP
423
Servicio HTTP y WebDAV con código 423: recurso bloqueado
Nivel de riesgo
Seguro
Puedes actuar sin peligro siguiendo las comprobaciones seguras.
Urgencia
Media — atiéndelo hoy
Respuesta rápida
El estado HTTP 423 Locked (Bloqueado) en WebDAV indica que el recurso de origen o de destino está bloqueado. Revisa el cuerpo XML DAV:error (lock-token-submitted o no-conflicting-lock), comprueba qué URI en href retiene el bloqueo y envía el token en la cabecera If o ejecuta UNLOCK.
Seguridad primero
Antes de continuar
- No fuerces la eliminación de bloqueos WebDAV en servidores compartidos ni sobrescribas archivos sin verificar antes quién posee el bloqueo: RFC 4918 exige presentar el lock token precisamente para evitar que un programa pise los cambios no guardados de otro.
- No confundas la respuesta exitosa 204 (No Content) de un método UNLOCK con la ausencia total de otros bloqueos si el recurso admitía bloqueos compartidos, y oculta siempre las cabeceras Authorization antes de adjuntar trazas HTTP.
Puedes hacerlo con seguridad
- Inspeccionar el cuerpo XML DAV:error o 207 Multi-Status para extraer la precondición y el D:href bloqueado
- Verificar el envío del lock token en la cabecera If para todos los recursos modificados
- Liberar un bloqueo obsoleto mediante el método UNLOCK y la cabecera Lock-Token en el alcance correcto
Deja estas tareas a un profesional cualificado
- No intentes esta tarea profesional: Corrección del manejo de cabeceras If y Lock-Token en el equipo de desarrollo del cliente WebDAV
- No intentes esta tarea profesional: Auditoría de bloqueos activos y tiempos de expiración con el administrador del servidor WebDAV
Lo que un técnico debe poder justificar
Viene un técnico
Estos son los pasos que tiene que hacer y enseñarte. Márcalos mientras trabaja: si se salta pasos, no aceptes el cambio de pieza.
No son instrucciones para que abras o manipules el equipo. Son las comprobaciones que deben sostener una conclusión técnica.
Corrección del manejo de cabeceras If y Lock-Token en el equipo de desarrollo del cliente WebDAV
Qué haceAjustar el cliente HTTP/WebDAV para que lea las URIs devueltas en lock-token-submitted (incluidas colecciones padre con bloqueo depth-infinity), envíe los tokens requeridos en la cabecera If (formato Tagged-List cuando intervienen varios recursos) y utilice la cabecera Lock-Token en las peticiones UNLOCK.
Te tiene que enseñarla traza de prueba superando un bloqueo en colección padre mediante Tagged-List en la cabecera If y un ciclo LOCK/UNLOCK que devuelve 204 No Content.
Por escritoel cambio de código en el cliente WebDAV y el tratamiento de las precondiciones lock-token-submitted y no-conflicting-lock.
Auditoría de bloqueos activos y tiempos de expiración con el administrador del servidor WebDAV
Qué haceCuando una petición legítima recibe 423 Locked por bloqueos huérfanos de sesiones cerradas o cuando UNLOCK responde 403 Forbidden, solicitar al administrador del servidor WebDAV la inspección de la tabla de bloqueos (lockdiscovery) y su liberación controlada.
Te tiene que enseñarel registro del bloqueo activo sobre la URI indicada en D:href (propietario, alcance depth y token) y el resultado tras expirar o revocar el bloqueo huérfano.
Por escritoel identificador de la incidencia, el recurso desbloqueado y la política de timeout aplicada en el servidor.
Antes de aceptar una pieza o reparación
Aún no ha demostrado nada. No aceptes un cambio de pieza solo por el código.
Sigue estos pasos
Aviso: Sigue el orden documentado. Un código identifica el sistema afectado, pero por sí solo no demuestra qué pieza está averiada.
Inspeccionar el cuerpo XML DAV:error o 207 Multi-Status para extraer la precondición y el D:href bloqueado
- Quién:
- Tú como persona desarrolladora o administradora analizando la respuesta HTTP 423 del servidor WebDAV.
- Cómo:
- Lee el cuerpo XML de la respuesta 423 (o el bloque response con estado HTTP/1.1 423 Locked dentro de un 207 Multi-Status) e identifica si el elemento D:error contiene lock-token-submitted o no-conflicting-lock, anotando cada URI listada en sus elementos hijos D:href.
- Resultado que importa:
- Identificación exacta de la URI raíz que impide la operación y del tipo de conflicto de bloqueo.
- Si D:href dentro de lock-token-submitted apunta a una colección padre distinta de la Request-URI enviada, confirma un bloqueo indirecto depth-infinity heredado de esa colección superior.
- Si el elemento devuelto es no-conflicting-lock durante un método LOCK, confirma que ya existe un bloqueo activo incompatible sobre ese recurso o uno de sus miembros e indica consultar la propiedad lockdiscovery.
- Evidencia a conservar:
- Conserva la petición HTTP (método, Request-URI y cabecera Destination si existe) y el XML D:error completo sin credenciales.
Evidencia: IANA HTTP Status Code Registry · RFC 4918 - WebDAV
Verificar el envío del lock token en la cabecera If para todos los recursos modificados
- Quién:
- Tú revisando las cabeceras de petición generadas por el cliente WebDAV o script de sincronización.
- Cómo:
- Si el principal autenticado es el titular del bloqueo y desea modificar el recurso sin desbloquearlo, comprueba que la petición incluya la cabecera If con el token urn:uuid correspondiente (en formato Tagged-List para la URI bloqueada o No-Tag-List), aportando dos tokens si un MOVE altera tanto un origen como un destino bloqueados, pero solo el del destino en un COPY.
- Resultado que importa:
- Cumplimiento de la regla de envío de tokens de RFC 4918 sección 7.5 para evitar colisiones entre programas del mismo usuario.
- Si al añadir en la cabecera If el lock token del recurso o de la colección padre la operación devuelve 200 OK, 201 Created o 204 No Content, confirma que faltaba presentar el token y descarta un fallo del servidor.
- Si el cliente desconoce el token o el bloqueo pertenece a otra sesión que quedó colgada, indica valorar la liberación mediante el método UNLOCK.
- Evidencia a conservar:
- Guarda la traza con la cabecera If probada (formato Tagged-List o No-Tag-List) y el código HTTP resultante.
Evidencia: RFC 4918 - WebDAV
Liberar un bloqueo obsoleto mediante el método UNLOCK y la cabecera Lock-Token en el alcance correcto
- Quién:
- Tú como titular del bloqueo o persona administradora con permisos sobre el recurso WebDAV.
- Cómo:
- Cuando el bloqueo ya no deba mantenerse, envía una petición HTTP UNLOCK dirigida a una Request-URI dentro del alcance del bloqueo incluyendo la cabecera Lock-Token con el identificador entre paréntesis angulares (por ejemplo Lock-Token: <urn:uuid:...>).
- Resultado que importa:
- Eliminación protocolaria del bloqueo específico en el servidor WebDAV con respuesta esperada 204 No Content.
- Si el método UNLOCK responde 204 (No Content), confirma que ese bloqueo ha quedado eliminado y que puedes reintentar la operación original.
- Si UNLOCK devuelve 400 (Bad Request por falta de token), 403 (Forbidden por falta de permisos del principal) o 409 (Conflict con lock-token-matches-request-uri porque la URI está fuera del alcance o el bloqueo ya expiró), indica escalar al administrador del servidor WebDAV.
- Evidencia a conservar:
- Registra la petición UNLOCK, la URI empleada y el estado HTTP devuelto (204, 400, 403 o 409).
No elimines por la fuerza bloqueos activos de otros usuarios ni desactives controles de autenticación sin confirmar antes qué proceso o sesión está editando el recurso.
Evidencia: RFC 4918 - WebDAV
Situación no resuelta
Si el error persiste, no sigas probando por tu cuenta. Mira qué tiene que hacer y enseñarte el técnico.
Dónde se aplica este código
Un código solo tiene significado dentro del producto y la versión correctos.
Ámbito principal
- Sistema
- Software y sistemas
- Marca
- HTTP
- Tipo de producto
- Servicio HTTP
Variantes conocidas del código
- 423 Bloccato
- 423 Bloqueado
- 423 Gesperrt
- 423 Locked
- 423 Verrouillé
- Bosch 423 bici elettrica
- Bosch 423 bicicleta eléctrica
- Bosch 423 E-Bike
- Bosch 423 eBike
- Bosch 423 vélo électrique
- Bosch eBike code 423
- Bosch eBike error 423
- Bosch eBike Fehler 423
- Bosch eBike Fehlercode 423
- code Bosch eBike 423
- codice Bosch eBike 423
- código Bosch eBike 423
- erreur Bosch eBike 423
- error Bosch eBike 423
- errore Bosch eBike 423
- HTTP 423
- HTTP status 423
Qué significa
En el registro oficial HTTP de IANA y en RFC 4918 (WebDAV, secciones 7.5, 9.11, 11.3 y 16), el servidor devuelve 423 (Locked) cuando el recurso de origen o de destino de un método está sujeto a un bloqueo activo incompatible con la petición. RFC 4918 establece que la respuesta debe incluir un elemento XML de precondición o postcondición como lock-token-submitted (con al menos un elemento href que identifica la URI bloqueada, incluido un bloqueo depth-infinity heredado de una colección padre) o no-conflicting-lock cuando falla una petición LOCK. El código 423 describe un estado de concurrencia del protocolo WebDAV y por sí solo nunca demuestra un fallo del servidor ni del almacenamiento.
Advertencias y condiciones de parada
- Precauciónverificada con fuente
No fuerces la eliminación de bloqueos WebDAV en servidores compartidos ni sobrescribas archivos sin verificar antes quién posee el bloqueo: RFC 4918 exige presentar el lock token precisamente para evitar que un programa pise los cambios no guardados de otro.
Evidencia: RFC 4918 - WebDAV
- Seguroverificada con fuente
No confundas la respuesta exitosa 204 (No Content) de un método UNLOCK con la ausencia total de otros bloqueos si el recurso admitía bloqueos compartidos, y oculta siempre las cabeceras Authorization antes de adjuntar trazas HTTP.
Evidencia: RFC 4918 - WebDAV
Síntomas y causas
Causas probables · en orden
- Omisión del token de bloqueo en la cabecera If al modificar un recurso o colección bloqueados (lock-token-submitted)Confirmada
RFC 4918 (secciones 7.5 y 16) exige que un principal autorizado envíe el lock token en la cabecera If para cada recurso bloqueado que el método vaya a cambiar (incluyendo origen y destino si ambos se modifican en MOVE); si falta el token, la petición falla con 423 Locked y la precondición lock-token-submitted.
Evidencia: IANA HTTP Status Code Registry · RFC 4918 - WebDAV
- Bloqueo indirecto heredado de una colección padre con alcance depth-infinityFrecuente
Como ilustra RFC 4918 en las secciones 7.5.2 y 16, cuando una colección superior (por ejemplo /workspace/webdav/ o /locked/) posee un bloqueo de escritura exclusivo depth-infinity, cualquier intento de modificar o borrar un miembro interno sin aportar el token de la colección padre recibe 423 Locked con la URI padre en D:href.
Evidencia: RFC 4918 - WebDAV
- Solicitud de un nuevo bloqueo LOCK que entra en conflicto con otro bloqueo existente (no-conflicting-lock)Posible
Si un cliente envía un método LOCK (por ejemplo de alcance depth-infinity sobre una colección) cuando ya existe un bloqueo incompatible sobre el recurso o sobre alguno de sus miembros internos, RFC 4918 ordena rechazar la petición con 423 (Locked) y el código de precondición no-conflicting-lock.
Evidencia: RFC 4918 - WebDAV
Técnico virtual
¿Sigue apareciendo 423 tras comprobarlo?
Responde unas preguntas para acotar la causa probable y la siguiente acción segura. Es una orientación - nunca sustituye a un profesional.
Fuentes y referencias técnicas
- 1
IANA HTTP Status Code Registry
Internet Assigned Numbers Authority · 2025 · standard
- 2
IETF / RFC Editor · 2007 · standard
¿Te ha resultado útil esta ficha?