La nuova app di Microsoft Teams può mostrare l’errore “Something went wrong – PrefetchFailure (-2147024891, System.UnauthorizedAccessException)” quando si apre la scheda File di un canale. In questa guida trovi cause, diagnosi e rimedi efficaci: dalla pulizia cache ai workaround lato tenant.
Scenario e cosa accade esattamente
Su alcuni PC con la nuova interfaccia di Teams (build 24124.2315.2911.3357
), l’utente apre un team → un canale → la scheda File e viene bloccato dal messaggio:
Something went wrong – PrefetchFailure (-2147024891, System.UnauthorizedAccessException)
La stessa persona, con le stesse credenziali, riesce però ad accedere ai documenti:
- in Teams Classic;
- nel client web via browser;
- dalla sezione File nella barra laterale della nuova app (quindi non passando dalla scheda File del canale).
Il comportamento evidenzia quindi un problema circoscritto al flusso con cui la nuova UI pre‑recupera (prefetch) i metadati SharePoint della libreria documenti legata al canale.
Decodifica dell’errore
Il codice -2147024891
corrisponde all’HRESULT 0x80070005
, che identifica Accesso negato. L’eccezione .NET riportata (System.UnauthorizedAccessException
) è coerente: il client non riceve un token valido o incontra un veto di autorizzazione sul percorso che sta pre‑caricando.
Cause più probabili
Possibile causa | Dettagli |
---|---|
Cache corrotta di Teams | File locali danneggiati impediscono il pre‑fetch dei contenuti di SharePoint. La corruzione può derivare da aggiornamenti interrotti, crash del WebView o spazio su disco limitato. |
Comportamento della nuova UI | Alcune build recenti gestiscono in modo differente l’autenticazione e la sessione alla libreria documenti associata al canale. |
Policy di autenticazione | SharePoint Online può rifiutare o non onorare il token del nuovo client se sono in vigore restrizioni specifiche (ad esempio su protocolli legacy o su come il token viene scambiato dalla nuova UI). |
Altre cause possibili (meno comuni)
- Runtime WebView2 danneggiato o non aggiornato: la nuova app di Teams si appoggia al runtime; un’installazione problematica può influire sui flussi di autenticazione.
- Proxy/SSL inspection aggressivi: l’ispezione può interferire con i redirect OIDC o la validazione del token.
- Conditional Access con condizioni non soddisfatte solo nel percorso “Files tab” (per esempio restrizioni su applicazioni client o su session management differenziale).
- Permessi a livello di libreria non allineati per specifici canali o utenti (ruolo solo Visitatore o accesso ereditato interrotto).
Verifiche rapide prima di intervenire
- Conferma l’ambito: l’errore appare a tutti o solo ad alcuni utenti? Riguarda tutti i canali o soltanto canali specifici?
- Prova incrociata: lo stesso utente apre senza problemi i file da Teams Classic o dal browser? Se sì, il problema è localizzato alla nuova app.
- Controlla aggiornamenti di Teams: molte correzioni arrivano via in‑app update.
- Raccogli log con Ctrl + Alt + Shift + 1 (utile per un’eventuale escalation).
Soluzioni e workaround consigliati
Applica i passi in ordine: da quelli non invasivi a quelli amministrativi. In molto casi la sola pulizia della cache risolve definitivamente.
Soluzione | Quando utilizzarla | Passaggi operativi |
---|---|---|
Pulire la cache di Teams | Primo tentativo, non richiede diritti di amministratore. | Esci completamente da Teams (chiudi anche dai tray icons). Premi Win + R e incolla: %userprofile%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams Elimina tutti i file e le cartelle presenti. Apri il Task Manager e verifica che non restino processi ms-teams.exe o WebView2 ; in caso, termina il processo. Riavvia Teams e riprova l’accesso alla scheda File del canale. |
Tornare temporaneamente a Teams Classic | Se l’errore riguarda solo la nuova app. | Attiva l’interruttore Teams Classic dal profilo oppure usa il client web come soluzione ponte finché non arriva una build correttiva. |
Aggiornare all’ultima build di Teams | Per sfruttare eventuali fix rilasciati da Microsoft. | Apri … → Impostazioni → Informazioni su Teams e seleziona Verifica aggiornamenti. Dopo l’update, chiudi e riapri l’app. |
Abilitare protocolli di autenticazione legacy (tenant SharePoint) | Richiede ruolo SharePoint Admin. Utile se policy troppo restrittive bloccano il nuovo client. Da usare solo come workaround temporaneo. | Esegui in PowerShell (modulo SharePoint Online): # se necessario, installa il modulo Install-Module Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser collegati al tenant (sostituisci \) Connect-SPOService -Url https\://\-admin.sharepoint.com abilita temporaneamente i protocolli legacy Set-SPOTenant -LegacyAuthProtocolsEnabled \$true Attendi alcuni minuti, poi riavvia Teams e verifica. Ricorda di ripristinare a \$false non appena una build correttiva risolve il problema. |
Verificare permessi SharePoint/OneDrive | Se il problema è circoscritto a specifici team o a pochi utenti. | Apri la raccolta documenti collegata al canale e conferma che l’utente abbia almeno ruolo Membro. Verifica eventuali permessi univoci sulla cartella del canale. |
Escalation a Microsoft | Se nessuno dei rimedi funziona o non puoi modificare policy tenant. | Allega i log generati con Ctrl + Alt + Shift + 1, l’elenco delle build interessate, utenti coinvolti e il confronto Classic vs Nuova app. |
Approfondimento: perché la cache corrompe l’accesso alla scheda File
La relazione tra Teams e SharePoint passa attraverso token e cookies/session storage mantenuti nel profilo dell’utente e, nella nuova app, nel runtime WebView2. Se la cache contiene artefatti orfani (ad esempio riferimenti a un sito SharePoint rinominato, o token scaduti non rinnovati correttamente) il tentativo di pre‑caricare la libreria documenti fallisce con “Accesso negato”. La rimozione completa della cache costringe l’app a ricreare la sessione da zero, sbloccando la scheda.
Diagnostica mirata per amministratori
- Confronto ruoli: prendi un utente che vede l’errore e uno che non lo vede; confronta i ruoli sul sito SharePoint e sulla libreria “Documenti” legata al team.
- Controllo Conditional Access: verifica se esistono policy che discriminano per client app o per sessione interattiva/non interattiva. La scheda File potrebbe attraversare un percorso differente rispetto alla “sezione File” laterale.
- Verifica del WebView2: in App e funzionalità trova Microsoft Edge WebView2 Runtime e seleziona Ripara o aggiorna se disponibile.
- Spazio su disco e profilo utente: uno spazio insufficiente sotto
%LocalAppData%
può troncare download di pacchetti e cache parziali.
Best practice operative
- Distribuisci prima in test: replica il problema in un ambiente pilota prima di toccare il tenant di produzione.
- Monitora gli advisories: mantieni un controllo sul Message Center di Microsoft 365 per notifiche relative a Teams “New”.
- Limita i protocolli legacy: se li abiliti per risolvere l’emergenza, pianifica un follow‑up per riportare l’impostazione a
$false
appena possibile. - Documenta: registra esattamente versioni, passi, risultati e tempi; sarà prezioso per altri admin e per un’eventuale escalation.
Checklist rapida di risoluzione
- ✔ Cache pulita e app riavviata
- ✔ Aggiornamento all’ultima build completato
- ✔ Test incrociato: Classic/Browser ok
- ✔ Verifica permessi su SharePoint
- ✔ (Se necessario) LegacyAuth abilitato temporaneamente
- ✔ Raccolta log e dettagli ambiente pronti per il supporto
Domande frequenti
È sicuro abilitare -LegacyAuthProtocolsEnabled $true
?
È un workaround temporaneo. Abilitare protocolli legacy riduce il livello di sicurezza; usalo solo per sbloccare situazioni di emergenza, monitora e ripristina a $false
appena una nuova build di Teams risolve il bug.
Perché la sezione “File” laterale funziona, ma la scheda “File” del canale no?
I due percorsi attivano flussi di autenticazione e pre‑fetch diversi. Un token o un cookie danneggiato nella cache può colpire il flusso della scheda, lasciando indenne l’altro.
Serve reinstallare Windows?
No, nella stragrande maggioranza dei casi la combinazione “cache → aggiornamento → eventuale policy SharePoint” risolve senza procedure drastiche.
Runbook operativo (passo‑passo)
- Conferma il sintomo: riproduci l’errore aprendo la scheda File in almeno due canali diversi.
- Svuota la cache come descritto sopra e riavvia l’app. Se risolto, chiudi il caso.
- Controlla aggiornamenti e riprova. Se risolto, informa l’utente.
- Valuta l’impatto: quanti utenti? che build? È diffuso? Se sì, prepara un workaround organizzativo.
- Controlla i permessi SharePoint per i canali coinvolti. Correggi ruoli o eredità interrotta.
- Workaround tenant (se ammesso): abilita temporaneamente l’opzione legacy in SPO, attendi e verifica.
- Raccogli log e apri ticket se il problema persiste nonostante i passi precedenti.
Appendice: comandi utili per amministratori
Verificare lo stato dei protocolli legacy
Connect-SPOService -Url https://<tenant>-admin.sharepoint.com
(Get-SPOTenant).LegacyAuthProtocolsEnabled
Ripristinare i protocolli legacy a false
Connect-SPOService -Url https://<tenant>-admin.sharepoint.com
Set-SPOTenant -LegacyAuthProtocolsEnabled $false
Appendice: percorsi e suggerimenti di pulizia
- Percorso cache nuova app (Windows)
%userprofile%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams
- Processi da chiudere
ms-teams.exe
, eventuali processiWebView2
associati a Teams. - Dopo la pulizia
Effettua un sign‑in completo e prova prima su un canale poco utilizzato per ridurre la latenza del primo pre‑caricamento.
Modello di comunicazione agli utenti
Per ridurre i ticket duplicati, invia una breve comunicazione:
“Stiamo risolvendo un problema che impedisce l’apertura della scheda File in alcuni canali su Microsoft Teams (nuova app). Se visualizzi l’errore ‘PrefetchFailure (-2147024891)’, prova a chiudere Teams, svuota la cache e riapri l’app. In alternativa, usa temporaneamente Teams Classic o il browser. Grazie della collaborazione.”
Raccomandazioni finali
- Conserva un playbook aggiornato con i passi di diagnosi; evita interventi invasivi se non necessari.
- Quando abiliti una mitigazione tenant, annota data e scopo e pianifica il rollback.
- Promuovi l’igiene della cache: in presenza di aggiornamenti frequenti lato client, i residui possono accumularsi.
Sintesi “pronti all’uso”
Hai pochi minuti?
1) Svuota la cache → 2) Riavvia Teams → 3) Se fallisce, passa a Teams Classic o al browser in attesa di aggiornamento.
Se sei admin e il problema è diffuso: abilita temporaneamente -LegacyAuthProtocolsEnabled $true
in SharePoint Online e verifica se la nuova UI riprende a mostrare i file. Ripristina a false
appena disponibile una build correttiva.
Conclusioni
Il messaggio “PrefetchFailure (-2147024891, System.UnauthorizedAccessException)” nella scheda File dei canali di Microsoft Teams segnala quasi sempre una combinazione di cache locale compromessa e particolarità della nuova UI nel gestire l’autenticazione a SharePoint. Affrontalo con una sequenza ordinata: cache → aggiornamento → verifica permessi → policy tenant. In base ai casi raccolti, questo percorso consente di ripristinare l’operatività senza reinstallazioni drastiche né lunghi fermi, mantenendo nel contempo un buon profilo di sicurezza del tenant.
Riepilogo tabelle
Cause più probabili
Possibile causa | Dettagli |
---|---|
Cache corrotta di Teams | File locali danneggiati impediscono il pre‑fetch dei contenuti di SharePoint. |
Comportamento della nuova UI | Alcune build gestiscono in modo diverso l’autenticazione ai documenti SharePoint. |
Policy di autenticazione | SharePoint Online potrebbe rifiutare il token del nuovo client se i protocolli legacy sono disattivati. |
Soluzioni e work‑around proposti
Soluzione | Quando utilizzarla | Passaggi operativi |
---|---|---|
Pulire la cache di Teams | Primo tentativo, non richiede diritti di amministratore. | Esci da Teams. Win + R → incolla il percorso indicato. Elimina file e cartelle. Riavvia Teams. |
Tornare temporaneamente a Teams Classic | Se l’errore riguarda solo la nuova app. | Attiva l’interruttore “Teams Classic” o utilizza il browser. |
Aggiornare all’ultima build di Teams | Per applicare correzioni rilasciate da Microsoft. | Menu … → Impostazioni → Informazioni su Teams → Verifica aggiornamenti. |
Abilitare protocolli di autenticazione legacy (tenant SharePoint) | Richiede privilegi admin; utile come mitigazione temporanea. | Usa i comandi PowerShell mostrati in questa guida. Dopo qualche minuto riavvia Teams e riprova. |
Verificare permessi SharePoint/OneDrive | Se il problema riguarda solo alcuni team o utenti. | Controlla che l’utente abbia almeno ruolo Membro nella raccolta documenti collegata al canale. |
Escalation a Microsoft | Se i rimedi non funzionano o non puoi modificare le policy. | Apri ticket allegando i log raccolti con Ctrl + Alt + Shift + 1. |
Seguendo la sequenza cache → aggiornamento → policy SharePoint, la maggior parte dei casi riportati si è risolta senza reinstallare Windows o coinvolgere il supporto di secondo livello.