Cómo solucionar el error ERR_UNKNOWN_URL_SCHEME (9 soluciones rápidas)

Puntos clave

• El error ERR_UNKNOWN_URL_SCHEME aparece cuando un enlace utiliza un esquema de URL no compatible o malformado.
• La mayoría de los casos se solucionan con sencillos pasos del navegador, como borrar la caché o desactivar las extensiones.
• Android WebView necesita un manejo explícito de los esquemas no HTTP/HTTPS para evitar fallos.
• Unas reglas de redireccionamiento estables y un formato de URL limpio ayudan a evitar este error en todos los entornos.

Los enlaces tienen distintas finalidades en Internet. Algunos abren páginas. Algunos inician correos electrónicos. Algunos inician una aplicación en el dispositivo. Cuando el navegador no puede interpretar el tipo de enlace que recibe, se detiene y muestra net::err_unknown_url_scheme.

El error puede aparecer en un sitio web normal o dentro de una aplicación que carga contenido web. Un paso de inicio de sesión puede detenerse. Una redirección puede fallar. Una WebView en una aplicación Android puede congelarse antes de que aparezca la página. Cada ejemplo apunta a la misma idea. El enlace utiliza un formato que el navegador no admite.

Los equipos suelen encontrarse con este problema cuando prueban redireccionamientos o enlaces profundos. Los usuarios lo ven durante la navegación rutinaria. El patrón parece diferente en cada caso, pero la causa es consistente. El navegador llega a un esquema que no puede manejar, por lo que bloquea la petición en el primer paso.

La guía explica por qué el navegador se detiene en ese punto y qué puedes hacer a continuación. A continuación, pasa a las correcciones prácticas para los navegadores y a las correcciones técnicas para Android WebView.

La función de los esquemas de URL es la base para comprender el error, y cada sección se basa en esa idea para ayudarte a resolverlo o evitarlo.

~ Chrome muestra el mensaje net::ERR_UNKNOWN_URL_SCHEME cuando encuentra un esquema de URL no compatible.

¿Qué es el error net::err_unknown_url_scheme?

El error net::err_unknown_url_scheme aparece cuando un navegador encuentra un enlace que comienza con un esquema que no reconoce.

Cada URL comienza con una directiva que indica al navegador cómo debe gestionar la petición. Cuando la directiva queda fuera de la lista admitida, el navegador se detiene antes de cargar cualquier página o script.

El error señala un punto simple. La instrucción al inicio del enlace no puede corresponderse con una acción permitida. No se envía ninguna llamada de red al servidor. No se ejecuta ninguna lógica de aplicación. La solicitud finaliza en el momento en que falla el esquema.

Comprender este primer paso explica por qué aparece el error en navegadores, redireccionamientos y entornos WebView incrustados. La siguiente sección examina los desencadenantes habituales de este fallo.

Experimenta menos errores de alojamiento con Cloudways Autonomous

Cloudways Autonomous utiliza el autoescalado basado en Kubernetes y una infraestructura gestionada para reducir los problemas de configuración, gestionar automáticamente los picos de tráfico y mantener tu sitio estable y con capacidad de respuesta.

Prueba hoy

Causas del error Net::Err_Unknown_Url_Scheme

El error se forma cuando algo interfiere en la parte inicial de una URL. El navegador evalúa ese primer paso antes que cualquier otra cosa, por lo que cualquier perturbación en esta fase interrumpe la solicitud. Cuando esa instrucción de apertura deja de ser clara o no es compatible, la solicitud se detiene.

1. Un enlace comienza con un esquema que el navegador no admite

Algunos enlaces utilizan directivas fuera del conjunto permitido. Cuando el navegador no puede clasificar la directiva, la petición finaliza en la comprobación del esquema.

2. Una redirección introduce un esquema diferente

Una cadena de redireccionamiento puede modificar la URL. Un servicio de la ruta puede devolver un enlace que comience con un nuevo patrón. Una vez que el navegador alcanza ese patrón, el proceso se detiene.

3. Un prefijo malformado causado por una errata o un error de formato

La falta de dos puntos o la alteración del prefijo cambia la forma en que se analiza la URL. El navegador trata el texto modificado como un esquema separado y desconocido.

4. Extensiones del navegador que reescriben o filtran enlaces

Las extensiones pueden añadir parámetros o eliminar partes de una URL. Un cambio a nivel de directiva convierte el enlace en algo que el navegador no puede interpretar.

5. Cookies dañadas o datos de ruta almacenados en caché

Los datos de redirección antiguos pueden dirigir al navegador a una ruta obsoleta. Si esa ruta comienza con una directiva no admitida, la petición falla.

6. Conflictos de renderizado con la aceleración por hardware

Las capas de la GPU pueden fallar al procesar transiciones basadas en enlaces. Cuando el navegador detecta el fallo, bloquea la petición antes de cargar la página.

7. Cortafuegos o software de seguridad que bloquea la acción

Los filtros locales pueden restringir los enlaces que lanzan funciones a nivel de dispositivo. El navegador detiene la petición cuando la acción no está permitida.

8. WebView sin controlador para una acción requerida

La Vista Web carga páginas, pero no gestiona tareas externas por sí misma. Cuando un enlace requiere un manejador no definido en código, la vista se detiene en ese punto.

Cloudways Performance Bootcamp – Gratuito – 10-11 mar

De CDN a Core Web Vitals: observa cómo los expertos solucionan problemas reales de rendimiento de WordPress, en directo.

Regístrate ahora →

Estas condiciones describen los puntos principales en los que la solicitud puede romperse. La siguiente sección cubre los pasos del lado del navegador que abordan estos puntos en términos prácticos.

Cómo solucionar el error Net::Err_Unknown_Url_Scheme (9 métodos sencillos)

Los navegadores bloquean la petición cuando una regla local, un valor almacenado en caché o una extensión alteran la forma de interpretar el enlace. Realizar los ajustes que se indican a continuación ayuda a reducir la causa y a restablecer el comportamiento esperado.

1. Desactiva las extensiones

Las extensiones a menudo reescriben URLs o filtran acciones. Desactivarlas proporciona al navegador un punto de partida limpio.

Pasos:

1. Abre Chrome.
2. Ve a chrome://extensions/.
3. Desactiva todas las extensiones.
4. Actualiza la página y vuelve a intentar el enlace.

2. Borrar cookies y datos almacenados en caché

Los datos de enrutamiento antiguos pueden enviar al navegador hacia rutas obsoletas. Borrar los archivos almacenados restablece la forma en que Chrome interpreta los enlaces.

Pasos:

1. Abre Chrome y ve a Configuración.
2. Selecciona Privacidad y Seguridad.
3. Haz clic en Eliminar datos de navegación.
4. Comprueba las cookies y los archivos almacenados en caché.
5. Haz clic en Borrar datos y vuelve a cargar la página.

3. Desactiva la aceleración gráfica

La renderización de la GPU puede fallar durante ciertas transiciones. Desactivar la aceleración gráfica elimina esa capa del proceso.

Pasos:

1. Abre la Configuración de Chrome.
2. Ve a Sistema.
3. Desactiva Usar aceleración gráfica cuando esté disponible.
4. Reinicia el navegador.

4. Prueba sin el cortafuegos

Algunos cortafuegos bloquean los enlaces que desencadenan acciones a nivel de dispositivo. Una breve prueba revela si una regla local detiene la petición.

Pasos:

• Abre la configuración del cortafuegos de tu sistema.

• Desactiva temporalmente el cortafuegos.
• Vuelve a intentar el enlace en Chrome.
• Vuelve a activar el cortafuegos inmediatamente después de la prueba.

5. Crear un nuevo perfil de navegador

Los perfiles almacenan preferencias, extensiones y reglas de enrutamiento almacenadas en caché. Un perfil nuevo elimina los cambios heredados.

Pasos:

• Abre Chrome.
• Haz clic en el icono de tu perfil (arriba a la derecha).
• Selecciona Añadir perfil de Chrome.

• Crea un perfil nuevo y limpio.
• Vuelve a abrir el enlace dentro del nuevo perfil.

6. Abrir el enlace en una ventana nueva

Algunos navegadores evalúan el enlace de forma diferente cuando cambia el contexto.

Pasos:

1. Haz clic con el botón derecho en el enlace.
2. Selecciona Abrir enlace en una pestaña nueva o Abrir enlace en una ventana nueva.
3. Comprueba si Chrome procesa el esquema correctamente.

7. Prueba un navegador sin cromo

Los distintos motores interpretan los esquemas de URL de formas diferentes. Probar fuera de Chromium ayuda a confirmar si el problema es específico del navegador.

Pasos:

1. Abre otro navegador (Firefox, Safari, etc.).
2. Pega el mismo enlace.
3. Compara cómo maneja el esquema el segundo navegador.

8. Restablecer indicadores del navegador

Las banderas experimentales pueden afectar a la navegación, el renderizado o el manejo de esquemas. Restablecerlas elimina el comportamiento no deseado.

Pasos:

1. Abre Chrome.
2. Ve a chrome://flags/.
3. Haz clic en Restablecer todo (arriba a la derecha).
4. Reinicia el navegador.

9. Actualiza el navegador a la última versión

Las versiones antiguas pueden contener errores de análisis o reglas de esquema obsoletas. La actualización garantiza que se aplique la lógica de tratamiento más reciente.

Pasos:

1. Abre la Configuración de Chrome.
2. Ve a Acerca de Chrome.
3. Chrome comprobará automáticamente si hay actualizaciones.
4. Aplica las actualizaciones y reinicia el navegador.
5. Vuelve a intentar el enlace.

Estos ajustes resuelven muchos fallos del lado del usuario. La siguiente sección cubre las correcciones a nivel de desarrollador para entornos WebView y de aplicaciones integradas, donde los esquemas no compatibles requieren un manejo explícito.

Correcciones para desarrolladores del error Net::Err_Unknown_Url_Scheme

WebView maneja páginas web estándar sin problemas. Los problemas aparecen cuando un enlace desencadena una acción fuera de la vista.

Una solicitud que deba abrir otra app, iniciar una función del dispositivo o seguir una directiva personalizada necesita un manejo claro en el código. Estos ajustes ayudan a WebView a procesar esas rutas y a reducir los fallos net::err_unknown_url_scheme en entornos Android.

Empieza con el método de anulación de URL, que WebView llama antes de cargar un enlace. Esto te da un punto para inspeccionar el esquema y decidir cómo debe moverse la petición. Los esquemas estándar permanecen dentro de la vista. Cualquier otra cosa necesita una ruta explícita.

#1 Manejar esquemas que la vista no puede procesar

Comprueba la URL dentro del método de anulación. Identifica el esquema. Decide si la acción pertenece a la vista o a otra aplicación. Esto aclara la ruta y evita que WebView adivine el siguiente paso.

#2 Usar intents para acciones que abren apps externas

Los enlaces que inician correo electrónico, mapas o mensajería no pueden ejecutarse dentro de WebView. Pasa esas acciones a una intent. Si falta la aplicación requerida, muestra un pequeño mensaje en lugar de dejar la vista en blanco.

Ejemplo de código:

@Anular

public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {

Uri uri = solicitud.getUrl();




String scheme = uri.getScheme();

if ("http".equals(scheme) || "https".equals(scheme)) {

return false; // Cargar dentro de WebView

}




prueba {

Intent = new Intent(Intent.ACTION_VIEW, uri);

view.getContext().startActivity(intent);

} catch (Excepción e) {

// App no instalada

}




devuelve verdadero;

}

#3 Restringe la vista cuando no se necesiten acciones externas

Algunas aplicaciones sólo muestran contenido web. En esos casos, acepta sólo http y https. Bloquea todo lo demás y redirige al usuario a un punto estable de la interfaz.

#4 Haz coincidir el método de anulación con el nivel de API del dispositivo

Las versiones antiguas de Android utilizan el método de anulación basado en cadenas. Las versiones más recientes pasan un objeto de solicitud. Utilizar la versión incorrecta provoca un comportamiento incoherente entre dispositivos. Confirma el nivel de API de destino y elige la firma correcta.

#5 Validar las URL antes de pasarlas a la vista

Los enlaces pueden proceder de APIs, datos almacenados o entradas del usuario. Un prefijo malformado provocará un fallo inmediato. Valida cada URL antes de cargarla.

#6 Añadir comportamiento fallback para acciones no soportadas

Algunos esquemas pertenecen a características que no apoyas. Proporciona una respuesta controlada. Redirige al usuario a un lugar seguro o muestra un pequeño aviso. Esto evita paradas silenciosas en el flujo de trabajo.

Estos ajustes proporcionan a WebView reglas de enrutamiento claras y reducen el comportamiento inesperado entre dispositivos.

La siguiente sección cubre técnicas de depuración más profundas que ayudan a exponer problemas no visibles durante las pruebas básicas.

Pasos avanzados de depuración que los desarrolladores suelen pasar por alto

Algunos problemas sólo aparecen cuando el enlace pasa por redireccionamientos reales o entornos de dispositivos mixtos. Estas comprobaciones ayudan a descubrir problemas que no aparecen durante las pruebas básicas y a menudo explican por qué net::err_unknown_url_scheme aparece de forma incoherente entre los usuarios.

Empieza por rastrear cómo evoluciona el enlace. Una cadena de redireccionamiento puede alterar el prefijo. Una llamada de retorno puede devolver un patrón personalizado. Un servicio de la cadena puede formatear la URL de forma diferente para los dispositivos móviles. Seguir la cadena revela qué capa cambia el esquema.

Comprueba la versión de Android System WebView

Las distintas versiones de WebView gestionan los esquemas de formas diferentes. Un dispositivo puede utilizar el paquete WebView independiente. Otro puede depender de una versión respaldada por Chrome. Confirma la versión de WebView en los dispositivos de prueba para identificar comportamientos no coincidentes.

Inspecciona las entradas del manifiesto y los filtros de intención

Algunas acciones requieren filtros explícitos en el manifiesto. Las entradas que faltan o están mal configuradas impiden que Android enrute el enlace correctamente.

Comprueba las actividades exportadas y confirma que los filtros de intención coinciden con los esquemas que esperas admitir.

Registra la URL completa antes de que WebView la cargue

Un enlace puede parecer correcto en la interfaz pero contener cambios ocultos. Registra la URL en el método de anulación y compárala con la original. Las diferencias en el prefijo o en el formato revelan el punto de fallo.

Rastrear redireccionamientos backend en flujos de trabajo alojados

Un servidor puede enviar un enlace limpio. Un servicio de terceros puede que no. Inspecciona cada paso de la redirección, especialmente en los flujos de inicio de sesión o de pago. Algunas devoluciones de llamada introducen prefijos personalizados que las vistas basadas en Chromium no reconocen.

Valida el enlace final fuera de la app

Abre la URL final en un navegador independiente. Si el navegador se detiene antes de tiempo, el problema está en el propio enlace. Si el navegador carga la página pero WebView falla, el problema está en el manejo a nivel de aplicación.

Prueba en entornos mixtos

Algunos dispositivos manejan los esquemas de forma diferente según la implementación de WebView o la versión del sistema. Probar en un único dispositivo puede ocultar incoherencias a nivel de API. Utiliza al menos dos versiones de Android para identificar las diferencias del entorno.

Estos pasos sacan a la luz problemas sutiles que las pruebas rutinarias pasan por alto. Una vez que se aclara el comportamiento subyacente, el siguiente objetivo es la prevención.

La siguiente sección esboza patrones que ayudan a evitar esquemas no compatibles en primer lugar.

Evita los errores de esquema de URL con el alojamiento WordPress de Cloudways

El alojamiento gestionado de WordPress de Cloudways garantiza configuraciones de servidor estables, un manejo adecuado de PHP y entornos fiables para mantener tu sitio sin errores.

PRUEBA AHORA

Buenas prácticas para evitar el error Net::Err_Unknown_Url_Scheme

La prevención de net::err_unknown_url_scheme comienza con un comportamiento predecible de los enlaces. Cuando el esquema se mantiene consistente a través de redirecciones, vistas incrustadas y dispositivos, el flujo de trabajo permanece estable. Los patrones siguientes ayudan a reducir las directivas no admitidas antes de que entren en la ruta.

Utiliza reglas claras para los esquemas aceptables. Un conjunto reducido de prefijos permitidos mantiene predecible el comportamiento de la aplicación. El contenido estándar debe basarse en http y https. Cualquier enlace que active una función del dispositivo debe ser deliberado, documentado y enrutado a través del código.

Valida los enlaces antes de que el usuario llegue a ellos. Muchos enlaces proceden de API o de datos almacenados. Un paso de validación elimina antes los prefijos malformados y evita que WebView o el navegador lleguen a instrucciones no compatibles.

Dirige las acciones externas a través de gestores conocidos. Los enlaces que abren el correo electrónico, los mapas o la mensajería deben pasar por una ruta controlada. Un manejador o intención aclara la acción y elimina las conjeturas dentro de WebView.

Supervisa el comportamiento de las redirecciones en los flujos que dependen de las devoluciones de llamada. Una ruta de inicio de sesión o de pago puede implicar varios servicios. Cada salto puede introducir un nuevo prefijo. Rastrea el flujo periódicamente para asegurarte de que la URL final vuelve con un esquema compatible.

Mantén la coherencia entre los entornos de desarrollo, ensayo y producción. Diferentes versiones de WebView o actualizaciones del navegador pueden cambiar cómo se interpretan los esquemas. Probar una pequeña gama de entornos expone los cambios antes de que lleguen a los usuarios.

Asegúrate de que los redireccionamientos del backend permanecen estables. Una respuesta del servidor que reescriba prefijos aumenta la posibilidad de esquemas no compatibles. Las reglas de redireccionamiento limpias reducen estas incoherencias.

Los equipos que alojan aplicaciones en Cloudways pueden reforzar esto manteniendo la lógica de enrutamiento consistente en todos los entornos. Una ruta de despliegue estable reduce los cambios inesperados bajo carga.

Estas prácticas ayudan a mantener un comportamiento predecible entre navegadores, dispositivos y vistas incrustadas. Algunos puntos de referencia rápida a continuación facilitan la identificación de patrones comunes al revisar los enlaces.

Puntos de referencia útiles

• Esquemas permitidos:
  • http
  • https
• Esquemas comunes no admitidos:
  • mailto
  • tel
  • intención
  • Prefijos personalizados

Estas prácticas crean un flujo de trabajo predecible y reducen los esquemas no compatibles antes de que interrumpan al usuario o a la WebView.

Cuándo contactar con el promotor

Algunos casos quedan fuera de la resolución rutinaria de problemas. Implican un comportamiento de enlace controlado por la propia aplicación o por un servicio de la cadena de redireccionamiento. Cuando el problema proviene del código o del enrutamiento externo, un desarrollador necesita revisar el flujo.

Ponte en contacto con el desarrollador cuando el enlace se origine dentro de la aplicación. Un enlace incrustado en la interfaz puede utilizar un esquema que requiera un manejador. Si la vista se congela o se detiene, el manejador falta o está incompleto.

Alcanza cuando un servicio de terceros controle parte de la redirección. Un proveedor de acceso, una pasarela de pago o una API externa pueden devolver un esquema que el navegador no puede interpretar. Sólo el propietario del servicio puede ajustar esa respuesta.

Pide ayuda cuando la aplicación dependa de acciones personalizadas. Algunas aplicaciones activan tareas a nivel de dispositivo utilizando sus propios patrones. Estos patrones deben estar documentados y soportados en el código. Los esquemas no soportados requieren un cambio de código, no un ajuste del navegador.

Solicita una revisión cuando el formato del enlace cambie entre entornos. Un enlace puede funcionar en la fase de pruebas pero fallar en producción. Esto suele indicar una regla de reescritura o redirección del lado del servidor. El desarrollador puede rastrear la regla y restaurar el comportamiento esperado.

En estas situaciones, las correcciones del lado del usuario no resolverán el problema. El comportamiento del enlace depende del código, de la configuración o de servicios externos. Un desarrollador puede identificar la fuente y aplicar los cambios necesarios.

Reflexiones finales

El error net::err_unknown_url_scheme se forma cuando un navegador o WebView no puede hacer coincidir un enlace con una acción admitida. La petición termina en ese primer paso, antes de que aparezca ninguna lógica de servidor. Encontrar dónde se desplaza la directiva te da un punto de partida claro para el arreglo.

Los ajustes del navegador gestionan las causas locales. Los manejadores a nivel de aplicación gestionan las acciones externas. Los redireccionamientos estables mantienen el flujo predecible en todos los entornos. Cada capa apoya a la siguiente, y el error se vuelve raro una vez que la ruta de enrutamiento es coherente.

Un flujo de trabajo que trata los esquemas con cuidado evita rupturas inesperadas. Cuando la ruta del enlace permanece estable, la ruta del usuario también lo hace.

Los equipos que ejecutan aplicaciones en staging y producción pueden reforzar esto manteniendo alineadas las reglas de enrutamiento, reduciendo los cambios inesperados durante el despliegue.