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.
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.
- Aggiornare Windows con Impostazioni > Windows Update fino a installare tutte le patch disponibili, quindi riavviare.
- Reinstallare Teams da Impostazioni > App > App installate:
- Ripristino → Ripara (se disponibile),
- Ripristino → Reimposta,
- Disinstalla completamente,
- Installa di nuovo l’ultima versione di Teams per lavoro/scuola.
- 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.
- 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.
- 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. - 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. - Prova WebView2 Canary/Beta. Se funziona, resta in anteprima finché l’evergreen stabile non integra la correzione; documenta la versione che risolve.
- Installa Teams offline “All users” (MSIX completo). Le distribuzioni per utente possono coesistere con residui del “Teams classico” e confondere i binding.
- Valuta policy e whitelisting. AppLocker/WDAC, antivirus con behavioral blocking e proxy TLS inspection possono bloccare runtime e updater.
- 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 eventi → Applications 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\<versione></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
eDISM /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.