Ao abrir Arquivos de canais no New Teams, alguns usuários recebem “Something went wrong… PrefetchFailure (-2147024891, System.UnauthorizedAccessException)”. Veja por que acontece, como diagnosticar e as correções mais eficazes — do cache a ajustes no SharePoint.
Sintoma e mensagem de erro
Em computadores com o New Teams (por exemplo, versão 24124.2315.2911.3357), ao clicar na guia Arquivos de qualquer canal, o cliente exibe a mensagem abaixo e não lista o conteúdo:
Something went wrong. Please try again or refresh the page.
PrefetchFailure (-2147024891, System.UnauthorizedAccessException)
Contexto reportado por usuários e equipes de suporte:
- No Teams Classic e no navegador, os arquivos abrem normalmente.
- O ícone Files da barra lateral do New Teams exibe as bibliotecas e documentos; o erro ocorre apenas ao abrir Arquivos dentro do canal.
- Já foram tentadas as ações “Sair/Entrar”, reinstalar o cliente e reiniciar o Windows, sem sucesso.
Causas prováveis e o que está acontecendo
O código -2147024891 corresponde a E_ACCESSDENIED (acesso negado). Na prática, o New Teams falha ao pré-buscar (prefetch) metadados da biblioteca do SharePoint associada ao canal, resultando em System.UnauthorizedAccessException. As causas mais comuns incluem:
- Cache e tokens do New Teams corrompidos ou desatualizados, especialmente após upgrades do cliente, troca de senha ou mudanças de MFA/condicionais.
- Diferenças de autenticação entre o fluxo que o New Teams usa para a guia Arquivos do canal e o que é usado pelo ícone Files ou pelo navegador.
- Condições específicas do ambiente: políticas de segurança, proxy/inspeção TLS, ou bloqueios seletivos de chamadas ao SharePoint/Graph apenas no cliente New Teams.
| Sinal observado | Interpretação provável |
|---|---|
| Classic e Web funcionam; falha só no New Teams | Indício forte de cache/tokens locais do novo cliente ou chamada específica do New Teams sendo bloqueada |
| Ícone Files lista conteúdo; guia Arquivos do canal falha | Fluxo de autenticação e escopo diferentes para o componente de canal |
| Erro exibe UnauthorizedAccessException | Problema de permissão/apresentação de token ao SharePoint (não necessariamente falta de acesso real) |
Correção por etapas sem risco para dados
Limpar o cache do New Teams no Windows
Esta é a ação com maior taxa de sucesso para esse cenário, pois força a renovação de tokens do cliente.
- Feche o New Teams completamente: clique com o botão direito no ícone da bandeja e escolha Quit.
- Pressione Win + R e cole o caminho abaixo:
%userprofile%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams - Apague todos os arquivos e pastas dentro desse diretório.
- Abra o New Teams novamente e faça login.
Variação por interface do Windows: Configurações > Aplicativos > Microsoft Teams (novo) > Opções avançadas > Redefinir.
Dica para suporte: se preferir automatizar, use o script PowerShell abaixo (execute no contexto do usuário afetado):
taskkill /IM ms-teams.exe /F 2>NUL
Start-Sleep -Seconds 2
$path = "$env:USERPROFILE\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams"
If (Test-Path $path) { Remove-Item "$path\*" -Recurse -Force -ErrorAction SilentlyContinue }
Start-Process "$env:LOCALAPPDATA\Microsoft\WindowsApps\ms-teams.exe"
Observação: Limpar o cache não remove arquivos do SharePoint/OneDrive; atua apenas no cliente.
Confirmar que o problema é específico do New Teams
Enquanto a correção definitiva não é aplicada, utilize um dos contornos abaixo para não interromper o trabalho:
- Acesse a mesma equipe e canal pelo Teams Classic ou via navegador.
- Mantenha o New Teams para chat/reuniões, mas abra Arquivos pelo navegador quando necessário.
Se o Classic/Web funcionam e o New Teams continua falhando após limpar o cache, avance para as seções de verificação e, em ambientes gerenciados, considere o teste de autenticação legado no SharePoint (apenas para administradores).
Verificações essenciais antes de alterar políticas
- Permissões no SharePoint do time: abra o site do time direto no navegador e confirme que você consegue listar e abrir arquivos na biblioteca “Documentos”.
- Gerenciador de Credenciais do Windows: remova entradas antigas relacionadas a MicrosoftOffice/SharePoint/Teams e faça login novamente.
- Atualização do New Teams: verifique se há versão mais recente; muitas correções são distribuídas por atualização do cliente.
- Proxy e inspeção SSL: confirme que hosts como teams.microsoft.com, graph.microsoft.com e domínios do SharePoint da sua organização não estão sendo interceptados/bloqueados especificamente para o executável do New Teams.
- Condições de Acesso (MFA, dispositivo compatível, status de risco): valide se o dispositivo e o usuário cumprem as políticas exigidas.
Ajuste avançado para administradores com cautela
Somente administradores devem executar este teste e sempre avaliando impacto de segurança. Em alguns ambientes, habilitar temporariamente protocolos legados de autenticação no SharePoint Online elimina o UnauthorizedAccessException que o New Teams dispara nesta rota específica.
Como testar a autenticação legada no SharePoint Online
Exemplo com o PowerShell do SharePoint Online:
# Instalar o módulo, se necessário
Install-Module Microsoft.Online.SharePoint.PowerShell -Scope CurrentUser
Conectar ao admin center do SharePoint Online
Connect-SPOService -Url https\://\-admin.sharepoint.com
Conferir o estado atual
Get-SPOTenant | Select LegacyAuthProtocolsEnabled
Habilitar protocolos legados (teste temporário)
Set-SPOTenant -LegacyAuthProtocolsEnabled \$True Objetivo: permitir protocolos legados que algumas chamadas do cliente possam estar usando, desbloqueando o acesso e eliminando o erro de UnauthorizedAccessException no prefetch.
Riscos e recomendações:
- Habilitar autenticação legada pode reduzir a segurança. Trate apenas como teste temporário para diagnóstico.
- Documente a mudança, valide se o New Teams passa a abrir a guia Arquivos sem o erro, e avalie se há alternativa mais segura.
- Se a habilitação não for essencial, retorne ao estado anterior:
Set-SPOTenant -LegacyAuthProtocolsEnabled $False
Fluxo de decisão recomendado
- Reproduza o erro somente no New Teams e capture a mensagem completa.
- Limpe o cache do New Teams conforme orientação acima e teste novamente.
- Valide acesso direto no site do SharePoint pelo navegador com a mesma conta.
- Cheque credenciais salvas no Windows e atualize o New Teams.
- Teste contorno: Classic ou Web para manter a produtividade.
- Ambiente gerenciado: se persistir e houver indícios de autenticação, executar o teste controlado com
-LegacyAuthProtocolsEnabled $True, monitorar e reverter se não for imprescindível.
Matriz de impacto e esforço
| Ação | Intrusividade | Risco | Tempo típico | Quando usar |
|---|---|---|---|---|
| Limpar cache do New Teams | Baixa | Baixo | Minutos | Primeira tentativa em quase todos os casos |
| Usar Classic/Web como contorno | Baixa | Baixo | Imediato | Manter operação enquanto investiga causa-raiz |
| Remover credenciais antigas no Windows | Média | Baixo | Minutos | Após troca de senha/MFA ou contas múltiplas |
| Habilitar autenticação legada no SPO | Alta | Médio/Alto | Minutos | Teste temporário em ambientes corporativos com falha persistente |
Checklist de verificação rápida
- New Teams fechado de fato antes de limpar o cache.
- Caminho de cache correto removido sem erros.
- Login bem-sucedido após a limpeza; MFA concluído se solicitado.
- Site do SharePoint abre no navegador com os mesmos privilégios do usuário.
- Windows Credential Manager sem entradas antigas de Office/SharePoint/Teams.
- Cliente New Teams atualizado para a versão mais recente disponível.
- Sem bloqueios seletivos no proxy/inspeção TLS para endpoints do Teams/Graph/SharePoint.
Perguntas frequentes
O que significa PrefetchFailure com UnauthorizedAccessException?
Indica que o cliente não conseguiu pré-carregar informações necessárias (como metadados da biblioteca do SharePoint) por falta de um token válido ou por recusa do serviço ao token apresentado, resultando em acesso negado.
Por que o ícone Files funciona e a guia Arquivos do canal não?
Porque são fluxos de chamada e escopos de autenticação diferentes. O componente de canal pode exigir permissões/escopos adicionais ou usar outra rota para o SharePoint; se o cache do New Teams estiver inconsistente, a guia falha enquanto o módulo lateral ainda consegue listar itens.
Limpar o cache vai apagar arquivos do meu time?
Não. O cache é local do aplicativo. Os arquivos permanecem no SharePoint/OneDrive. Você apenas fará login novamente e o cliente reconstruirá o cache.
Quando considerar habilitar a autenticação legada no SharePoint?
Apenas para testes controlados por administradores quando há forte evidência de falha de autenticação específica do New Teams. Deve ser temporário e documentado, pois pode reduzir a postura de segurança.
Como coletar logs do New Teams para o suporte?
No cliente, pressione Ctrl + Alt + Shift + 1. Um pacote de logs será salvo na pasta de Downloads, útil para verificar erros de token, resposta do SharePoint/Graph e falhas de prefetch.
Reinstalar o New Teams resolve?
Nem sempre. Quando a causa é cache/tokens, reinstalar sem excluir o cache pode deixar o problema intacto. Por isso, a limpeza do cache costuma ser a primeira medida.
Posso forçar o New Teams a abrir a biblioteca no navegador?
Sim. Como contorno, acesse a equipe > canal > abra a biblioteca no navegador. É útil para seguir trabalhando enquanto se corrige o cliente.
Boas práticas para evitar recorrência
- Mantenha o New Teams atualizado regularmente.
- Após trocas de senha ou mudanças de MFA, encerre o cliente e faça login novamente para renovar tokens.
- Evite interferências indevidas do proxy/inspeção SSL nos domínios do Microsoft 365 usados pelo Teams e pelo SharePoint.
- Padronize o procedimento de limpeza de cache nos scripts de suporte, com validação e registro da ação.
Apêndice com scripts e caminhos úteis
Script PowerShell para limpeza rápida do New Teams
# Encerrar o New Teams
taskkill /IM ms-teams.exe /F 2>NUL
Start-Sleep -Seconds 2
Limpar cache do New Teams
\$cache = "\$env\:USERPROFILE\AppData\Local\Packages\MSTeams\_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams"
If (Test-Path \$cache) {
Remove-Item "\$cache\*" -Recurse -Force -ErrorAction SilentlyContinue
}
Iniciar o New Teams
Start-Process "\$env\:LOCALAPPDATA\Microsoft\WindowsApps\ms-teams.exe" Comandos para teste controlado no SharePoint Online
# Conectar ao admin center do SPO
Connect-SPOService -Url https://<sua-organização>-admin.sharepoint.com
Verificar estado atual da autenticação legada
Get-SPOTenant | Select LegacyAuthProtocolsEnabled
Habilitar temporariamente (somente para teste)
Set-SPOTenant -LegacyAuthProtocolsEnabled \$True
Reverter a configuração ao final do teste
Set-SPOTenant -LegacyAuthProtocolsEnabled \$False Locais e atalhos úteis
| Item | Como acessar |
|---|---|
| Cache do New Teams | %userprofile%\AppData\Local\Packages\MSTeams_8wekyb3d8bbwe\LocalCache\Microsoft\MSTeams |
| Reinício forçado do cliente | Encerrar pelo ícone da bandeja ou via taskkill /IM ms-teams.exe /F |
| Gerenciador de Credenciais | Painel de Controle > Contas de Usuário > Gerenciador de Credenciais |
| Coleta de logs | Atalho Ctrl + Alt + Shift + 1 no New Teams |
Resultados esperados após seguir o guia
- Em muitos casos, a limpa de cache resolve imediatamente o erro e a guia Arquivos volta a listar o conteúdo do canal.
- Se o problema persistir somente no New Teams, o uso temporário do Classic/Web mantém a produtividade enquanto se aguarda atualização corretiva.
- Em ambientes com políticas que afetam o fluxo de autenticação do New Teams, o teste controlado com
-LegacyAuthProtocolsEnabled $Trueajuda a confirmar a causa, devendo ser revertido se não for essencial.
Conclusão
O erro PrefetchFailure (-2147024891, System.UnauthorizedAccessException) ao abrir Arquivos de canais no New Teams geralmente está ligado a inconsistências de cache/tokens ou a diferenças no fluxo de autenticação para a guia de canal. Comece pela limpeza de cache — ação simples, segura e com alta taxa de sucesso. Valide o acesso direto no SharePoint, revise credenciais e políticas, e utilize o Classic/Web como contorno para não interromper o trabalho. Em ambientes corporativos, o teste temporário de autenticação legada no SharePoint Online pode ser útil para diagnóstico, mas exige avaliação de risco e retorno ao estado original. Com esse roteiro, você terá um caminho claro e prático para restaurar o acesso aos arquivos do canal no New Teams.