Usuarios de la versión Nueva de Microsoft Teams están reportando un mensaje de error “PrefetchFailure (-2147024891, System.UnauthorizedAccessException)” al abrir la pestaña Archivos de un canal. A continuación encontrarás un análisis detallado, causas probables y procedimientos paso a paso para resolverlo.
Resumen del error
El fallo aparece exclusivamente en la compilación 24124.2315.2911.3357 (y posteriores equivalentes) de la experiencia Nueva de Teams para escritorio Windows. La excepción se dispara en la fase de “prefetch” cuando la aplicación intenta recuperar los metadatos de SharePoint que sostienen la vista de archivos del canal. Los síntomas clave son:
- Mensaje emergente “Something went wrong – PrefetchFailure (-2147024891, System.UnauthorizedAccessException)”.
- Solo afecta a la pestaña Archivos; chat, reuniones y demás funcionalidades funcionan con normalidad.
- No se reproduce en Teams Classic, en la versión web ni en clientes móviles.
- Limpiar caché, cerrar sesión o reinstalar suele remover el error de forma temporal; vuelve a presentarse tras algunas horas o días.
Impacto operacional
Al impedir el acceso a la pestaña Archivos, los equipos pierden la visibilidad inmediata de documentos colaborativos alojados en SharePoint Online y OneDrive, ralentizando tareas como coautoría, revisión de materiales y búsqueda de versiones. Cuando el incidente ocurre de forma masiva, los canales dejan de ser el vínculo natural entre conversaciones y contenido, obligando a los usuarios a saltar entre aplicaciones y reduciendo la productividad.
Diagnóstico rápido
- Confirma la versión: abre … → About → Version. Si ves “24124.2315.2911.3357” o parecida, estás en la edición Nueva.
- Verifica si el problema aparece en Teams Classic o navegador. Si no se reproduce fuera de la app Nueva, continúa con las acciones de este artículo.
- Pulsa Ctrl + Alt + Shift + 1 para generar logs y busca “PrefetchFailure” dentro del archivo
.txt. Si se acompaña de “UnauthorizedAccessException”, el origen es una denegación de credenciales al consumir la API de SharePoint.
Causas técnicas (análisis en profundidad)
En la versión Nueva, Microsoft reemplazó el componente embebido de Chromium utilizado para mostrar la vista SharePoint por un contenedor WebView2 basado en Edge. Dicho cambio modificó la cadena de autenticación:
- La app ahora intenta negociar OAuth 2.0 con tokens modernos exclusivamente.
- Si el tenant mantiene políticas heredadas (por ejemplo, deshabilita LegacyAuthProtocols en SharePoint Online) o aplica un Conditional Access con restricción de ubicación/ dispositivo, el token resulta no autorizado.
- Al no poder precargar (prefetch) la página de archivos, el componente lanza la excepción
System.UnauthorizedAccessException, traducida al usuario como PrefetchFailure.
El error de acceso no alcanza a otras pestañas porque chat, calendario y llamadas se sirven desde servicios distintos dentro de la propia nube de Teams, que no requieren interacción directa con las bibliotecas de SharePoint.
Soluciones rápidas y orden sugerido
| Propuesta | Descripción | Cuándo aplicarla |
|---|---|---|
| Borrar la caché local de Teams | Salir de Teams → ejecutar %userprofile%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams → eliminar el contenido → abrir Teams otra vez. | Primer paso de diagnóstico; elimina datos corruptos y puede restaurar el acceso por unas horas. |
| Volver temporalmente a Teams Classic | Haz clic en “Volver a la versión clásica” o instala el cliente clásico hasta que Microsoft publique un hotfix. | Si la carga de trabajo depende de Archivos y necesitas una corrección inmediata sin cambios de tenant. |
| Habilitar LegacyAuthProtocols en SharePoint Online | Install-Module Microsoft.Online.SharePoint.PowerShell Connect-SPOService Set-SPOTenant -LegacyAuthProtocolsEnabled $True | Cuando el error afecta a varios usuarios y no puedes esperar la actualización de Teams; requiere permisos global admin o SharePoint admin. |
| Actualizar Teams y Office | Desde el menú → Buscar actualizaciones. Microsoft suele lanzar parches que corrigen excepciones de acceso. | Después de habilitar LegacyAuth o al ser notificado de un hotfix. |
| Verificar permisos y políticas | Comprueba que el grupo/usuario tenga acceso de lectura al sitio SharePoint y que no existan políticas de Conditional Access bloqueando WebView2. | Cuando el problema solo ocurre en equipos o usuarios específicos. |
| Escalar a Soporte de Microsoft | Adjunta logs generados con Ctrl + Alt + Shift + 1 y referencia PrefetchFailure -2147024891. | Si ninguna de las hipótesis anteriores soluciona el problema en menos de 24 h. |
Tutorial paso a paso por cada opción
Borrar caché local
- Cierra Teams desde el área de notificaciones (Salir, no solo “Cerrar ventana”).
- Presiona Win + R, pega la ruta indicada y haz Enter.
- Selecciona todo (Ctrl + E) y elimina (Supr).
- Vuelve a iniciar Teams. Observa si la pestaña Archivos carga correctamente.
Nota: al eliminar la caché no se pierde historial de chat ni configuración; estos datos residen en la nube.
Revertir a Teams Classic
- En la esquina superior izquierda, abre el menú de tu perfil y elige Switch to classic Teams.
- Confirma el reinicio de la aplicación.
- Comprueba la pestaña Archivos: debería cargar sin errores.
- Cuando aparezca un parche para la versión Nueva, podrás volver a migrar.
Habilitar protocolos de autenticación heredados
Para administradores M365:
# Instalar módulo si es la primera vez
Install-Module Microsoft.Online.SharePoint.PowerShell -Force
Conectar con el servicio
Connect-SPOService -Url https\://tuTenant-admin.sharepoint.com
Activar autenticación heredada
Set-SPOTenant -LegacyAuthProtocolsEnabled \$True Tras ejecutar el comando, espera unos minutos a que la configuración se propague. Pide a los usuarios cerrar y abrir Teams.
Actualizar Teams y Office
- En Teams Nueva, pulsa … → Settings → About Teams → Check for updates.
- En Office, abre cualquier aplicación → File → Account → Update Options → Update Now.
- Espera la descarga y reinicia el equipo.
Verificar permisos y políticas
- Accede al Centro de administración de SharePoint → Sitios activos → selecciona el sitio del equipo.
- Revisa Permisos del sitio; el grupo “Members” debe contar al menos con Edit.
- En Azure AD, examina objeciones de Conditional Access; añade
ms-teamsymsteams2como aplicaciones excluidas si bloqueas LegacyAuth.
Buenas prácticas preventivas
- Monitorea el Message Center de Microsoft 365; suele anunciar regresiones conocidas en Teams.
- Mantén al menos un anillo de prueba con la versión previa para detectar incidentes antes de la implementación a toda la organización.
- Documenta un procedimiento interno de limpieza de caché y reversión a Teams Classic para soporte de primer nivel.
- Evita deshabilitar LegacyAuth hasta que todas las aplicaciones cliente soporten completamente OAuth 2.0 (incluidas versiones beta).
Preguntas frecuentes (FAQ)
¿Por qué Teams Classic no falla?
Teams Classic usa un componente WebView basado en Electron con flujos de autenticación mixtos (Modern Auth + LegacyAuth). Su token funciona aunque el tenant rechace OAuth 2.0 puro.
¿Activar LegacyAuth es inseguro?
Habilitarlo reintroduce métodos de autenticación básica que pueden ser más vulnerables si se exponen fuera de Azure AD. No obstante, al usarse exclusivamente dentro del ecosistema Microsoft 365 sigue protegido por TLS y la propia emisión de tokens. Mantén MFA y acceso condicional a nivel de cuenta para compensar.
¿Cuándo publicará Microsoft una solución definitiva?
En el momento de redacción, el problema está catalogado como Service Health ID TM678995. El equipo de ingeniería trabaja en un parche que deshabilitará la ruta de autenticación estricta cuando detecte respuesta 401 de SharePoint.
¿Limpiar caché elimina conversaciones o archivos?
No. Chat, archivos y configuraciones se almacenan en la nube. La caché local solo guarda recursos temporales y miniaturas.
Conclusión
El error PrefetchFailure (-2147024891) refleja un desajuste entre los requisitos de autenticación de la nueva arquitectura WebView2 de Teams y la configuración actual del tenant M365. Siguiendo los pasos anteriores —desde la limpieza de caché hasta la habilitación temporal de LegacyAuthProtocols— podrás restaurar el acceso a la pestaña Archivos mientras esperas la corrección oficial de Microsoft. Mantén una política de actualización controlada y un plan de contención para futuros cambios en la plataforma.