Errore “We can’t find a required component to open Teams – Download Edge WebView2” su Windows 11: cause, fix comprovato e guida completa

Su Windows 11 l’app desktop di Microsoft Teams per lavoro/scuola può bloccarsi con l’errore “We can’t find a required component to open Teams – Download Edge WebView2”. Qui trovi cause, soluzione comprovata e una guida di troubleshooting completa e strutturata.

Indice

Panoramica del problema

Alcuni utenti di Microsoft Teams per aziende o scuole su Windows 11 incontrano un avviso in apertura: “We can’t find a required component to open Teams – Download Microsoft Edge WebView2 Runtime”. Dopo aver “scaricato” il componente, l’errore si ripresenta e l’app continua a non avviarsi, creando un loop tra download e apertura.

Il messaggio indica che Teams non riesce a inizializzare Microsoft Edge WebView2 Runtime, il motore Web che visualizza l’interfaccia moderna dell’app. Anche se il runtime risulta installato, può essere corrotto, non registrato correttamente, bloccato da policy o in conflitto con una copia precedente di Teams o con la sua cache locale.

Perché accade

Le cause più comuni osservate in ambienti moderni includono:

  • Corruzione o registrazione incompleta del runtime WebView2 dopo aggiornamenti di sistema o interruzioni durante l’update.
  • Mismatch di livello tra installazioni per-utente e per-dispositivo (system-level) di WebView2 o Teams.
  • Cache di Teams danneggiata o residui del “Teams classico” che interferiscono con il “nuovo Teams”.
  • Policy aziendali (GPO/MDM) che limitano l’esecuzione o l’aggiornamento del runtime WebView2.
  • File di sistema danneggiati, servizi di aggiornamento Edge/Windows non in esecuzione o pending reboot dopo patch.
  • Driver/Rendering: problemi GPU o settaggi sandbox che inibiscono il rendering WebView2.

Soluzione applicata con successo

Caso “Simone”: la sequenza seguente ha rimosso il loop ed eliminato l’errore.

  1. Aggiornare Windows con Impostazioni > Windows Update fino a installare tutte le patch disponibili, quindi riavviare.
  2. Reinstallare Teams da Impostazioni > App > App installate:
    • RipristinoRipara (se disponibile),
    • RipristinoReimposta,
    • Disinstalla completamente,
    • Installa di nuovo l’ultima versione di Teams per lavoro/scuola.
  3. Reinstallare in modo pulito Edge WebView2:
    • Disinstallare Microsoft Edge WebView2 Runtime da App e funzionalità, oppure con il comando seguente (Prompt dei comandi come amministratore):
    cmd "%ProgramFiles(x86)%\Microsoft\EdgeWebView\Application<versione>\Installer\setup.exe" --uninstall --msedgewebview --system-level --verbose-logging --force-uninstall
    • Scaricare il WebView2 Evergreen Stand‑alone installer (x64) dal sito Microsoft e installarlo nuovamente a livello di sistema.
  4. Riavviare il PC e aprire Teams: l’errore scompare, l’app si avvia regolarmente.
<details>
  <summary>Variante via riga di comando con PowerShell</summary>
  <p>Esegui PowerShell come amministratore per forzare pulizia e reinstallazione.</p>
  <pre><code class="language-powershell"># 1) Aggiornamenti di sistema

Install-Module PSWindowsUpdate -Scope CurrentUser -Force Import-Module PSWindowsUpdate Get-WindowsUpdate -AcceptAll -Install -AutoReboot 2) Disinstallazione Teams (se presente) Get-Package -Name “Teams” -ErrorAction SilentlyContinue | Uninstall-Package -Force 3) Disinstallazione WebView2 se noto il percorso (sostituisci ) $wvPath = “$Env:ProgramFiles(x86)\Microsoft\EdgeWebView\Application<versione>\Installer\setup.exe” Start-Process $wvPath -ArgumentList “–uninstall –msedgewebview –system-level –verbose-logging –force-uninstall” -Wait 4) Dopo aver installato manualmente il pacchetto Evergreen x64, verifica la versione installata $root = “$Env:ProgramFiles(x86)\Microsoft\EdgeWebView\Application” Get-ChildItem $root -Directory | Sort-Object Name -Descending | Select-Object -First 1 | ForEach-Object { $exe = Join-Path $_.FullName “msedgewebview2.exe” (Get-Item $exe).VersionInfo | Select-Object ProductVersion, FileVersion }

Problema ancora aperto

Caso “Satyabh”: per un secondo utente, la sequenza precedente non è bastata. In questi scenari, è opportuno estendere la diagnostica con i passaggi aggiuntivi sottostanti, che coprono le cause residue nella maggior parte dei contesti gestiti e non.

Approccio di troubleshooting consigliato

Questi step ampliano la soluzione originale e attaccano le radici tecniche più frequenti.

<div class="table-wrap">
  <table>
    <thead>
      <tr>
        <th>Fase</th>
        <th>Azione</th>
        <th>Dettagli</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><strong>A. Controllo integrità di sistema</strong></td>
        <td>SFC / DISM</td>
        <td>
          Eseguire in PowerShell con diritti di amministratore:<br>
          <code>sfc /scannow</code><br>
          <code>DISM /Online /Cleanup-Image /RestoreHealth</code><br>
          Corregge file di sistema o component store che possono impedire la corretta registrazione di WebView2.
        </td>
      </tr>
      <tr>
        <td><strong>B. Installatore offline di Teams</strong></td>
        <td>Usare il pacchetto completo (MSIX)</td>
        <td>
          Scaricare l’ultima build “Teams for work or school (x64) – All users” dal Microsoft Download Center; disinstallare la versione corrente e installare quella offline.
          In ambienti senza Store o con proxy restrittivi, l’MSIX completo aggira molte dipendenze rotte.
        </td>
      </tr>
      <tr>
        <td><strong>C. WebView2 Preview</strong></td>
        <td>Provare la versione di anteprima</td>
        <td>
          Installare temporaneamente Microsoft Edge WebView2 <em>Canary/Beta</em>. Alcune build risolvono bug presenti nell’evergreen stabile. Se funziona, il problema è nella versione stabile attuale.
        </td>
      </tr>
      <tr>
        <td><strong>D. Reimpostazione cache Teams</strong></td>
        <td>Cancellare cartelle temporanee</td>
        <td>
          Chiudere completamente Teams, poi eliminare:<br>
          <code>%AppData%\Microsoft\Teams</code>,<br>
          <code>%LocalAppData%\Microsoft\Teams</code>,<br>
          <code>%AppData%\Microsoft\TeamsMeetingAddin</code>.<br>
          Per il <em>nuovo</em> Teams (MSIX), verificare anche in <code>%LocalAppData%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache</code>.
        </td>
      </tr>
      <tr>
        <td><strong>E. Politiche di sicurezza</strong></td>
        <td>Verificare policy aziendali</td>
        <td>
          In ambienti gestiti, GPO/MDM possono bloccare WebView2; chiedere all’amministratore di controllare <code>HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\WebView2</code> ed eventuali regole AppLocker o WDAC che impediscono l’esecuzione dei binari in <code>Program Files (x86)\Microsoft\EdgeWebView</code>.
        </td>
      </tr>
      <tr>
        <td><strong>F. Log di diagnostica</strong></td>
        <td>Abilitare logging Verbose</td>
        <td>
          Avviare Teams con <code>--disable-gpu --verbose-logging</code> e analizzare <code>SquirrelSetup.log</code> o i log in <code>%AppData%\Microsoft\Teams\logs.txt</code> per errori di binding WebView2.
        </td>
      </tr>
    </tbody>
  </table>
</div>

<details>
  <summary>Script pratici e verifiche da riga di comando</summary>
  <h3>Verificare servizi e task di aggiornamento Edge</h3>
  <pre><code class="language-powershell"># Verifica servizi Edge Update

Get-Service | Where-Object {$_.Name -like “edgeupdate*”} Verifica attività pianificate di Edge Update (machine-level) Get-ScheduledTask -TaskName “MicrosoftEdgeUpdateTaskMachine*” | Format-Table TaskName, State, LastRunTime

  <h3>Controllare la versione effettiva di WebView2</h3>
  <pre><code class="language-powershell">$root = "$Env:ProgramFiles(x86)\Microsoft\EdgeWebView\Application"

Get-ChildItem $root -Directory | Sort-Object Name -Descending | Select-Object -First 1 | ForEach-Object { $exe = Join-Path $*.FullName “msedgewebview2.exe” [PSCustomObject]@{ RuntimeFolder = $*.FullName FileVersion = (Get-Item $exe).VersionInfo.FileVersion ProductVersion= (Get-Item $exe).VersionInfo.ProductVersion } }

  <h3>Avvio di Teams con flag di diagnostica</h3>
  <pre><code class="language-powershell">$teamsExeCandidates = @(

“$Env:LOCALAPPDATA\Microsoft\Teams\current\Teams.exe”, “$Env:ProgramFiles\WindowsApps\MSTeams_*\ms-teams.exe” ) $exe = $teamsExeCandidates | Where-Object { Test-Path $_ } | Select-Object -First 1 if ($exe) { Start-Process $exe -ArgumentList “–disable-gpu –verbose-logging” } else { Write-Host “Eseguibile di Teams non trovato nelle posizioni note.” }

  <h3>Ripulire la cache in modo sicuro</h3>
  <pre><code class="language-powershell"># Chiudi Teams prima di procedere!

$paths = @( “$Env:APPDATA\Microsoft\Teams”, “$Env:LOCALAPPDATA\Microsoft\Teams”, “$Env:APPDATA\Microsoft\TeamsMeetingAddin”, “$Env:LOCALAPPDATA\Packages\MSTeams_8wekyb3d8bbwe\LocalCache” ) foreach ($p in $paths) { if (Test-Path $p) { Remove-Item $p -Recurse -Force -ErrorAction SilentlyContinue } }

Strategia ragionata di isolamento del guasto

Se l’errore persiste, segui questo percorso decisionale per identificare il punto di rottura.

  1. Controlla la versione di WebView2 e conferma che una directory di versione sia presente in Program Files (x86)\Microsoft\EdgeWebView\Application. Se non c’è o è vuota, reinstalla l’Evergreen stand‑alone x64 a livello di sistema.
  2. Esegui Teams con flag --disable-gpu. Se parte, il problema è nel renderer GPU: aggiorna o reinstalla i driver grafici e lascia il flag solo come mitigazione temporanea.
  3. Prova WebView2 Canary/Beta. Se funziona, resta in anteprima finché l’evergreen stabile non integra la correzione; documenta la versione che risolve.
  4. Installa Teams offline “All users” (MSIX completo). Le distribuzioni per utente possono coesistere con residui del “Teams classico” e confondere i binding.
  5. Valuta policy e whitelisting. AppLocker/WDAC, antivirus con behavioral blocking e proxy TLS inspection possono bloccare runtime e updater.
  6. Ripara il sistema con SFC/DISM. Se errori persistono, considera In‑place Upgrade o Reset conservativo di Windows (ultima ratio).

Segnali diagnostici da cercare nei log

  • Log Teams in %AppData%\Microsoft\Teams\logs.txt: stringhe come “webview initialization failed”, “could not find Edge WebView2 runtime”, “Class not registered”.
  • SquirrelSetup.log (per installazioni legacy non‑MSIX) con errori durante l’estrazione dei file o nella registrazione dei protocolli.
  • Visualizzatore eventiApplications and Services Logs > Microsoft > Windows > AppXDeployment-Server per errori durante l’installazione MSIX.
  • Eventi Application con .NET/Win32 che indicano HRESULT 0x80040154 (REGDBECLASSNOTREG) o 0x80070002 (file non trovato).

Consigli operativi e buone pratiche

  • Mantieni Edge aggiornato: il runtime WebView2 condivide motore e ciclo di rilascio con Edge Stable.
  • Installa a livello di sistema con privilegi locali, specie su PC condivisi o con profili utente temporanei/roaming.
  • Evita installazioni miste: rimuovi versioni per utente prima di passare a All users.
  • Gestione cache: prima di cancellare le cartelle, termina tutti i processi di Teams/Teams Meeting Add-in dal Task Manager.
  • Soluzione temporanea: accedi alla versione web di Teams per continuità operativa mentre completi la correzione sul desktop.
  • In azienda: apri un ticket Microsoft 365 support allegando i log di installazione WebView2 e i log di Teams (%AppData%\Microsoft\Teams\logs.txt) per accelerare l’analisi.

Domande frequenti

Qual è la differenza tra Edge e Edge WebView2 Runtime?

Microsoft Edge è il browser; WebView2 Runtime è un componente headless che consente alle applicazioni (come Teams) di visualizzare interfacce Web usando il motore di Edge. Possono convivere versioni diverse e aggiornarsi separatamente.

<h3>Serve disinstallare Edge per riparare WebView2?</h3>
<p>No. Edge e WebView2 sono correlati ma indipendenti. Disinstallare Edge non è necessario né consigliabile; è sufficiente riparare o reinstallare il runtime WebView2.</p>

<h3>Dopo aver reinstallato WebView2 l’errore persiste: cosa controllo per primo?</h3>
<p>
  Verifica che la directory di <code>Application\&lt;versione&gt;</code> in <code>Program Files (x86)\Microsoft\EdgeWebView</code> contenga i binari (in particolare <code>msedgewebview2.exe</code>), che le policy non lo blocchino e che Teams non venga ridiretto a una vecchia cache. In caso di dubbi, passa al pacchetto <em>All users</em> di Teams e resetta le cache.
</p>

<h3>Come capisco se sto usando il “nuovo Teams” o il “classico”?</h3>
<p>
  Il <em>nuovo Teams</em> è distribuito in MSIX e memorizza dati anche sotto <code>%LocalAppData%\Packages\MSTeams_8wekyb3d8bbwe</code>. Il “classico” usa <code>%AppData%\Microsoft\Teams</code> e un meccanismo di auto‑update basato su Squirrel.
</p>

Checklist rapida

  • Installa tutte le patch di Windows e riavvia.
  • Disinstalla Teams e reinstallalo (preferibilmente pacchetto All users).
  • Disinstalla e reinstallare da zero Edge WebView2 Evergreen x64.
  • Esegui SFC /scannow e DISM /RestoreHealth.
  • Resetta la cache di Teams (vecchio e nuovo percorso).
  • Escludi blocchi da policy/AppLocker/WDAC.
  • Attiva logging verbose e ispeziona i log.

Riassunto

  • L’errore è causato da una mancata registrazione o corruzione di Edge WebView2 Runtime, componente essenziale per l’interfaccia di Teams.
  • Una reinstallazione pulita di WebView2 unita alla reinstallazione di Teams (e all’aggiornamento di Windows) ha risolto il problema per il primo utente (caso Simone).
  • Se l’errore persiste, procedere con verifica integrità di sistema, installatori offline, reset cache e controllo delle policy. Queste azioni coprono quasi tutte le cause note fino a ottobre 2025.

Appendice: comandi pronti all’uso

Prompt dei comandi

cmd
:: Disinstallazione forzata WebView2 (sostituisci <versione>)
"%ProgramFiles(x86)%\Microsoft\EdgeWebView\Application<versione>\Installer\setup.exe" --uninstall --msedgewebview --system-level --verbose-logging --force-uninstall

:: Verifica integrità
sfc /scannow
DISM /Online /Cleanup-Image /RestoreHealth 

PowerShell

# Avvio Teams con diagnostica GPU disabilitata
$teams = "$Env:LOCALAPPDATA\Microsoft\Teams\current\Teams.exe"
if (Test-Path $teams) { Start-Process $teams -ArgumentList "--disable-gpu --verbose-logging" }

Pulizia cache (vecchio + nuovo Teams)

$cache = @(
"$Env:APPDATA\Microsoft\Teams",
"$Env:LOCALAPPDATA\Microsoft\Teams",
"$Env:APPDATA\Microsoft\TeamsMeetingAddin",
"$Env:LOCALAPPDATA\Packages\MSTeams_8wekyb3d8bbwe\LocalCache"
)
$cache | ForEach-Object { if (Test-Path $) { Remove-Item $ -Recurse -Force -ErrorAction SilentlyContinue } } 

Note importanti

  • Esegui sempre i passaggi con un account con privilegi locali (amministratore del dispositivo) quando installi a livello di sistema.
  • Se usi software di sicurezza con controlli restrittivi, valuta esclusioni sui percorsi WebView2 e Teams.
  • Evita di interrompere aggiornamenti in corso: completali e riavvia prima di procedere con reinstallazioni.
  • In VDI/ambienti multi‑utente, preferisci installazioni machine‑wide e profili utente “puliti” per il test.
Indice