Cosa significa davvero
L'errore 502.5 - ANCM Out-Of-Process Startup Failure indica che IIS ha ricevuto la richiesta, ma il processo dell'applicazione ASP.NET Core non è partito correttamente o si è chiuso subito dopo l'avvio. Il punto chiave è che il problema quasi mai è "IIS rotto": la causa è di solito nella runtime, nella configurazione o nei permessi dell'app.
Verifiche iniziali
- Hosting Bundle — verifica che la versione .NET richiesta dall'app sia realmente installata sul server.
- Stdout log temporaneo — abilitalo solo per diagnosi, così intercetti eccezioni di bootstrap che l'HTTP 502.5 non mostra.
- Identity dell'Application Pool — controlla accessi a cartelle, certificati, share SMB, chiavi di registro e secret esterni.
- Variabili e dipendenze — stringhe di connessione mancanti, endpoint non raggiungibili o certificati non caricabili bloccano spesso l'avvio.
Dove guardare
Oltre ai log applicativi, controlla Windows Event Viewer, stdout logs e il file web.config pubblicato. Se l'app parte da riga di comando ma fallisce sotto IIS, il problema è quasi sempre legato a identity, working directory, permessi o differenze di environment.
Approccio corretto
Il troubleshooting efficace consiste nel confermare la runtime, validare i permessi dell'identity usata da IIS, verificare dipendenze esterne e raccogliere l'eccezione precisa all'avvio. Riavvii ripetuti dell'application pool senza evidenze servono solo a nascondere temporaneamente il problema.