Lección 4
Depurar URLs en logs y APIs
Usa componentes analizados para depurar redirecciones, firmas, claves de caché y enlaces de seguimiento.
Cuando aparece un error de URL en producción, la cadena completa suele ser ruidosa. Analízala primero, luego compara componentes.
Errores de redirección
Para redirecciones, comprueba:
- Esquema y host
- Ruta con o sin barra final
- Valores de consulta que contienen URLs codificadas
- Valores de fragmento que nunca llegan al servidor
Los errores de redirección OAuth a menudo se ocultan dentro de URLs anidadas:
redirect_uri=https%3A%2F%2Fapp.example.com%2Fcallback%3Fnext%3D%252Fbilling
Decodifica una capa a la vez. Decodificar todo de una vez puede ocultar qué capa posee qué delimitador.
Errores de firma
Para URLs firmadas, compara:
- Orden de parámetros
- Codificación porcentual
- Campos incluidos y excluidos
- Valores de marca de tiempo y caducidad
- Reglas de mayúsculas de host y ruta
El firmante y el verificador deben canonicalizar la URL de la misma forma.
Errores de caché
Las cachés pueden tratar estas URLs como distintas:
?a=1&b=2
?b=2&a=1
O pueden normalizarlas a la misma clave de caché. Conoce qué regla usa tu CDN, proxy o capa de aplicación.
Un flujo de trabajo práctico
- Guarda la URL original exactamente como se observó.
- Analízala en componentes.
- Decodifica valores solo en la capa que estás inspeccionando.
- Compara componentes esperados y reales.
- Reconstruye la URL usando reglas explícitas.
El objetivo no es hacer la URL bonita. El objetivo es preservar el significado que espera el sistema receptor.