Résolution des problèmes courants pour Azure App Service et IIS avec ASP.NET Core

Cette rubrique décrit les erreurs les plus courantes et fournit des conseils de résolution de problèmes dans le cadre de l’hébergement d’applications ASP.NET Core sur Azure App Service et IIS.

Consultez les informations de résolution des problèmes liés à ASP.NET Core sur Azure App Service et IIS sur les erreurs courantes de démarrage d’application et des instructions sur la façon de diagnostiquer les erreurs.

Collectez les informations suivantes :

• Comportement du navigateur tel qu’un code d’état et un message d’erreur.
• Entrées du journal des événements de l’application
  • Azure App Service : consultez Résoudre les problèmes liés à ASP.NET Core sur Azure App Service et IIS.
  • IIS
    1. Sélectionnez Démarrer dans le menu Windows, tapez Observateur d’événements, puis appuyez sur Entrée.
    2. Une fois l’Observateur d’événements ouvert, développez Journaux Windows>Application dans la barre latérale.
• Entrées de journal stdout et de débogage du module ASP.NET Core
  • Azure App Service : consultez Résoudre les problèmes liés à ASP.NET Core sur Azure App Service et IIS.
  • IIS : suivez les instructions fournies dans les sections Création et redirection de journal et Journaux de diagnostic améliorés de la rubrique Module ASP.NET Core.

Comparez les informations d’erreur aux erreurs courantes suivantes. Si vous trouvez une correspondance, suivez les conseils de dépannage.

La liste d’erreurs de cette rubrique n’est pas exhaustive. Si vous rencontrez une erreur non listée ici, ouvrez un nouveau problème à l’aide du bouton de Commentaires sur le contenu situé au bas de cette rubrique, puis fournissez des instructions détaillées sur la manière de reproduire l’erreur.

Important

Préversions d’ASP.NET Core avec Azure App Service

Les préversions d’ASP.NET Core ne sont pas déployées sur Azure App Service par défaut. Pour héberger une application qui utilise une préversion d’ASP.NET Core, consultez Déployer la préversion d’ASP.NET Core sur Azure App Service.

La mise à niveau du système d’exploitation a supprimé le Module ASP.NET Core 32 bits

Journal des applications : Le fichier DLL C:\WINDOWS\system32\inetsrv\aspnetcore.dll du module n’a pas pu se charger. Les données sont erronées.

Résolution des problèmes :

Les fichiers autres que les fichiers de système d’exploitation dans le répertoire C:\Windows\SysWOW64\inetsrv ne sont pas conservés pendant la mise à niveau du système d’exploitation. Si le module ASP.NET Core est installé avant la mise à niveau d’un système d’exploitation et si un pool d’applications est exécuté en mode 32 bits après la mise à niveau du système d’exploitation, ce problème se produit. Après une mise à niveau du système d’exploitation, réparez le Module ASP.NET Core. Consultez Installer le bundle d’hébergement .NET Core. Sélectionnez Réparer quand le programme d’installation est exécuté.

Extension de site manquante, extensions de site 32 bits (x86) et 64 bits (x64) installées ou nombre de bits de processus incorrect défini

S’applique aux applications hébergées par Azure App Services.

• Navigateur : erreur HTTP 500.0 – Échec de chargement du gestionnaire in-process ANCM

• Journal des applications : échec de l’appel de hostfxr pour la recherche du gestionnaire de demandes in-process. Dépendances natives introuvables. Le gestionnaire de requêtes in-process est introuvable. Sortie capturée à partir de l’appel de hostfxr : Il n’a pas été possible de trouver une version de framework compatible. Le framework spécifié 'Microsoft.AspNetCore.App', version '{VERSION}-preview-*' est introuvable. Échec du démarrage de l’application « /LM/W3SVC/1416782824/ROOT ». Code d’erreur : 0x8000ffff.

• Journal stdout du module ASP.NET Core : Il n’a pas été possible de trouver une version de framework compatible. Le framework spécifié 'Microsoft.AspNetCore.App', version '{VERSION}-preview-*' est introuvable.

• Journal de débogage du module ASP.NET Core : Échec de l’appel de hostfxr pour la recherche du gestionnaire de demandes in-process. Dépendances natives introuvables. Cela signifie très probablement que l’application est mal configurée. Vérifiez les versions de Microsoft.NetCore.App et Microsoft.AspNetCore.App ciblées par l’application et installées sur la machine. HRESULT incorrect retourné : 0x8000ffff. Le gestionnaire de requêtes in-process est introuvable. Il n’a pas été possible de localiser une version compatible du framework. Le framework spécifié 'Microsoft.AspNetCore.App', version '{VERSION}-preview-*' est introuvable.

Résolution des problèmes :

• Si vous exécutez l’application sur un runtime en préversion, installez l’extension de site 32 bits (x86) ou 64 bits (x64) qui correspond au nombre de bits de l’application et à la version du runtime de l’application. N’installez pas les deux extensions ou plusieurs versions du runtime de l’extension.

  • Runtime ASP.NET Core {RUNTIME VERSION} (x86)
  • Runtime ASP.NET Core {RUNTIME VERSION} (x64)

  Redémarrez l’application. Patientez quelques secondes pour que l’application redémarre.

• Si vous exécutez l’application sur un runtime en préversion et que les deux extensions de site 32 bits (x86) et 64 bits (x64) sont installées, désinstallez l’extension de site qui ne correspond pas au nombre de bits de l’application. Après avoir supprimé l’extension de site, redémarrez l’application. Patientez quelques secondes pour que l’application redémarre.

• Si vous exécutez l’application sur un runtime en préversion et que le nombre de bits de l’extension de site correspond à celui de l’application, vérifiez que la version du runtime de l’extension de site en préversion correspond à la version du runtime de l’application.

• Vérifiez que la plateforme de l’application dans Paramètres de l’application correspond au nombre de bits de l’application.

Pour plus d’informations, consultez Déployer des applications ASP.NET Core sur Azure App Service.

Une application x86 est déployée mais le pool d’applications n’est pas activé pour les applications 32 bits

• Navigateur : erreur HTTP 500.30 – Échec du démarrage in-process ANCM

• Journal des applications : l’application '/LM/W3SVC/5/ROOT' avec la racine physique '{PATH}' a rencontré une exception managée inattendue. Code d’exception = '0xe0434352'. Pour plus d’informations, consultez les journaux stderr. L’application « /LM/W3SVC/5/ROOT » ayant pour racine physique « {PATH} » n’a pas pu charger clr et l’application managée. Sortie prématurée du thread de travail CLR

• Journal stdout du module ASP.NET Core : Le fichier journal est créé, mais vide.

• Journal de débogage du module ASP.NET Core : HRESULT incorrect retourné : 0x8007023e

Ce scénario est intercepté par le kit SDK au moment de la publication d’une application autonome. Le kit SDK génère une erreur si le RID ne correspond pas à la cible de la plateforme (par exemple, un RID win10-x64 avec <PlatformTarget>x86</PlatformTarget> dans le fichier projet).

Résolution des problèmes :

Pour un déploiement dépendant du framework x86 (<PlatformTarget>x86</PlatformTarget>), activez le pool d’applications IIS pour les applications 32 bits. Dans le Gestionnaire IIS, ouvrez les Paramètres avancés du pool d’applications, puis affectez à l’option Activer les applications 32 bits la valeur Vrai.

Conflits de plateforme avec RID

• Navigateur : Erreur HTTP 502.5 - Échec du processus

• Journal des applications : l’application 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' avec la racine physique 'C:{PATH}' n’a pas pu démarrer le processus avec la ligne de commande '"C:{PATH}{ASSEMBLY}.{exe|dll}" ', ErrorCode = '0x80004005 : ff.

• Journal stdout du module ASP.NET Core : Exception non gérée : System.BadImageFormatException : Impossible de charger le fichier ou l’assembly '{ASSEMBLY}.dll'. Tentative de chargement d’un programme au format incorrect.

Résolution des problèmes :

• Vérifiez que l’application s’exécute localement sur Kestrel. Un échec de processus peut être dû à un problème au niveau de l’application. Pour plus d’informations, consultez Résoudre les problèmes liés à ASP.NET Core sur Azure App Service et IIS.

• Si cette exception se produit pour un déploiement d’applications Azure pendant la mise à niveau d’une application et le déploiement de nouveaux assemblys, supprimez manuellement tous les fichiers du déploiement précédent. Le fait de laisser des assemblys incompatibles peut provoquer une exception System.BadImageFormatException lors du déploiement d’une application mise à niveau.

Point de terminaison d’URI incorrect ou site web arrêté

• Navigateur : ERR_CONNECTION_REFUSED --OU-- Connexion impossible

• Journal des applications : Aucune entrée

• Journal stdout du module ASP.NET Core : Le fichier journal n’est pas créé.

• Journal de débogage du module ASP.NET Core : Le fichier journal n’est pas créé.

Résolution des problèmes :

• Vérifiez que le point de terminaison d’URI approprié de l’application est en cours d’utilisation. Vérifiez les liaisons.

• Vérifiez que le site web IIS n’est pas à l’état Arrêté.

Fonctionnalités de serveur W3SVC ou CoreWebEngine désactivées

Exception de système d’exploitation : Les fonctionnalités CoreWebEngine et W3SVC d’IIS 7.0 doivent être installées pour utiliser le Module ASP.NET Core.

Résolution des problèmes :

Vérifiez que le rôle et les fonctionnalités appropriés sont activés. Consultez Configuration d’IIS.

Chemin physique de site web incorrect ou application manquante

• Navigateur : 403 - Interdit : accès refusé --ou-- 403.14 - Interdit : Le serveur Web est configuré pour ne pas afficher le contenu de ce répertoire.

• Journal des applications : Aucune entrée

• Journal stdout du module ASP.NET Core : Le fichier journal n’est pas créé.

• Journal de débogage du module ASP.NET Core : Le fichier journal n’est pas créé.

Résolution des problèmes :

Consultez les Paramètres de base du site web IIS et le dossier d’application physique. Vérifiez que l’application est dans le dossier sur le chemin physique du site web IIS.

Rôle incorrect, module ASP.NET Core non installé ou autorisations incorrectes

• Navigateur : 500.19 Erreur interne du serveur : Impossible d’accéder à la page que vous avez demandée, car les données de configuration connexes relatives à la page ne sont pas valides. --OU-- Impossible d’afficher cette page

• Journal des applications : Aucune entrée

• Journal stdout du module ASP.NET Core : Le fichier journal n’est pas créé.

• Journal de débogage du module ASP.NET Core : Le fichier journal n’est pas créé.

Résolution des problèmes :

• Vérifiez que le rôle approprié est activé. Consultez Configuration d’IIS.

• Ouvrez Programmes et fonctionnalités ou Applications et fonctionnalités, puis vérifiez que Windows Server Hosting est installé. Si Windows Server Hosting ne figure pas dans la liste des programmes installés, téléchargez et installez le bundle d’hébergement .NET Core.

  Programme d’installation du bundle d’hébergement .NET Core actuel (téléchargement direct)

  Pour plus d’informations, consultez Installer le bundle d’hébergement .NET Core.

• Vérifiez que Pool d’applications>Modèle de processus>Identity a la valeur ApplicationPoolIdentity ou que l’identité personnalisée dispose des autorisations appropriées pour accéder au dossier de déploiement de l’application.

• Si vous avez désinstallé le bundle d’hébergement ASP.NET Core et installé une version antérieure du bundle d’hébergement, le fichier applicationHost.config ne contient pas de section pour le module ASP.NET Core. Ouvrez applicationHost.config sur %windir%/System32/inetsrv/config et recherchez le groupe de sections <configuration><configSections><sectionGroup name="system.webServer">. Si la section pour le module ASP.NET Core ne se trouve pas dans le groupe de sections, ajoutez l’élément de section :

  <section name="aspNetCore" overrideModeDefault="Allow" />
  

  Sinon, installez la dernière version du bundle d’hébergement ASP.NET Core. La dernière version est rétrocompatible avec les applications ASP.NET Core prises en charge.

processPath incorrect, variable de chemin manquante, bundle d’hébergement non installé, système/IIS non redémarré, VC++ Redistributable non installé ou violation d’accès dotnet.exe

• Navigateur : erreur HTTP 500.0 – Échec de chargement du gestionnaire in-process ANCM

• Journal des applications : L’application 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' avec la racine physique 'C:{PATH}' n’a pas pu démarrer le processus avec la ligne de commande '"{...}" ', ErrorCode = '0x80070002 : 0. L’application « {PATH} » n’a pas pu démarrer. L’exécutable est introuvable sur « {PATH} ». Échec du démarrage de l’application « /LM/W3SVC/2/ROOT ». Code d’erreur : 0x8007023e.

• Journal stdout du module ASP.NET Core : Le fichier journal n’est pas créé.

• Journal de débogage du module ASP.NET Core : Journal des événements : 'L’application '{PATH}' n’a pas pu démarrer. L’exécutable est introuvable sur « {PATH} ». HRESULT incorrect retourné : 0x8007023e

Résolution des problèmes :

• Vérifiez que l’application s’exécute localement sur Kestrel. Un échec de processus peut être dû à un problème au niveau de l’application. Pour plus d’informations, consultez Résoudre les problèmes liés à ASP.NET Core sur Azure App Service et IIS.

• Examinez l’attribut processPath de l’élément <aspNetCore> dans web.config afin de vérifier qu’il s’agit de dotnet pour un déploiement dépendant du framework ou de .\{ASSEMBLY}.exe pour un déploiement autonome.

• Pour un déploiement dépendant du framework, dotnet.exe peut ne pas être accessible via les paramètres PATH. Vérifiez que C:\Program Files\dotnet\ existe dans les paramètres PATH du système.

• Dans le cas d’un déploiement dépendant du framework, dotnet.exe risque de ne pas être accessible pour l’identité de l’utilisateur du pool d’applications. Vérifiez que l’identité de l’utilisateur du pool d’applications a accès au répertoire C:\Program Files\dotnet. Vérifiez qu’aucune règle de refus d’accès n’est configurée pour l’identité de l’utilisateur du pool d’applications sur les répertoires C:\Program Files\dotnet et d’application.

• Peut-être qu’un déploiement dépendant du framework a été déployé et que .NET Core a été installé sans redémarrage d’IIS. Redémarrez le serveur ou IIS en exécutant net stop was /y suivi de net start w3svc à partir d’une invite de commandes.

• Peut-être qu’un déploiement dépendant du framework a été déployé sans que le runtime .NET Core soit installé sur le système hôte. Si le runtime .NET Core n’a pas été installé, exécutez le programme d’installation du bundle d’hébergement .NET Core sur le système.

  Programme d’installation du bundle d’hébergement .NET Core actuel (téléchargement direct)

  Pour plus d’informations, consultez Installer le bundle d’hébergement .NET Core.

  Si un runtime spécifique est nécessaire, téléchargez-le à partir de la page Téléchargements .NET, puis installez-le sur le système. Terminez l’installation en redémarrant le système ou IIS en exécutant net stop was /y suivi de net start w3svc à partir d’une invite de commandes.

Arguments incorrects de l’élément <aspNetCore>

• Navigateur : erreur HTTP 500.0 – Échec de chargement du gestionnaire in-process ANCM

• Journal des applications : échec de l’appel de hostfxr pour la recherche du gestionnaire de demandes in-process. Dépendances natives introuvables. Cela signifie très probablement que l’application est mal configurée. Vérifiez les versions de Microsoft.NetCore.App et Microsoft.AspNetCore.App ciblées par l’application et installées sur la machine. Le gestionnaire de requêtes in-process est introuvable. Sortie capturée de l’appel de hostfxr : Aviez-vous l’intention d’exécuter les commandes du kit SDK dotnet ? Installez le kit SDK dotnet à partir de : https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 Échec du démarrage de l’application '/LM/W3SVC/3/ROOT', ErrorCode '0x8000ffff'.

• Journal stdout du module ASP.NET Core : Aviez-vous l’intention d’exécuter les commandes du kit SDK dotnet ? Installez le kit SDK dotnet à partir de : https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409

• Journal de débogage du module ASP.NET Core : Échec de l’appel de hostfxr pour la recherche du gestionnaire de demandes in-process. Dépendances natives introuvables. Cela signifie très probablement que l’application est mal configurée. Vérifiez les versions de Microsoft.NetCore.App et Microsoft.AspNetCore.App ciblées par l’application et installées sur la machine. HRESULT incorrect retourné : 0x8000ffff Le gestionnaire de demandes in-process est introuvable. Sortie capturée de l’appel de hostfxr : Aviez-vous l’intention d’exécuter les commandes du kit SDK dotnet ? Installez le kit SDK dotnet à partir de : https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 HRESULT incorrect retourné : 0x8000ffff

Résolution des problèmes :

• Vérifiez que l’application s’exécute localement sur Kestrel. Un échec de processus peut être dû à un problème au niveau de l’application. Pour plus d’informations, consultez Résoudre les problèmes liés à ASP.NET Core sur Azure App Service et IIS.

• Examinez l’attribut arguments de l’élément <aspNetCore> dans web.config afin de vérifier (a) qu’il s’agit de .\{ASSEMBLY}.dll pour un déploiement dépendant du framework, ou (b) qu’il est absent ou qu’il s’agit d’une chaîne vide (arguments="") ou d’une liste d’arguments de l’application (arguments="{ARGUMENT_1}, {ARGUMENT_2}, ... {ARGUMENT_X}") pour un déploiement autonome.

Framework partagé .NET Core manquant

• Navigateur : erreur HTTP 500.0 – Échec de chargement du gestionnaire in-process ANCM

• Journal des applications : échec de l’appel de hostfxr pour la recherche du gestionnaire de demandes in-process. Dépendances natives introuvables. Cela signifie très probablement que l’application est mal configurée. Vérifiez les versions de Microsoft.NetCore.App et Microsoft.AspNetCore.App ciblées par l’application et installées sur la machine. Le gestionnaire de requêtes in-process est introuvable. Sortie capturée à partir de l’appel de hostfxr : Il n’a pas été possible de trouver une version de framework compatible. Le framework spécifié « Microsoft.AspNetCore.App », version « {VERSION} » est introuvable.

Échec du démarrage de l’application « /LM/W3SVC/5/ROOT ». Code d’erreur : 0x8000ffff.

• Journal stdout du module ASP.NET Core : Il n’a pas été possible de trouver une version de framework compatible. Le framework spécifié « Microsoft.AspNetCore.App », version « {VERSION} » est introuvable.

• Journal de débogage du module ASP.NET Core : HRESULT incorrect retourné : 0x8000ffff

Résolution des problèmes :

Pour un déploiement dépendant du framework, vérifiez que le runtime approprié est installé sur le système.

Pool d’applications arrêté

• Navigateur : 503 Service non disponible

• Journal des applications : Aucune entrée

• Journal stdout du module ASP.NET Core : Le fichier journal n’est pas créé.

• Journal de débogage du module ASP.NET Core : Le fichier journal n’est pas créé.

Résolution des problèmes :

Vérifiez que le pool d’applications n’est pas à l’état Arrêté.

La sous-application inclut une section <handlers>

• Navigateur : Erreur HTTP 500.19 : Erreur interne du serveur

• Journal des applications : Aucune entrée

• Journal stdout du module ASP.NET Core : Le fichier journal de l’application racine est créé et indique un fonctionnement normal. Le fichier journal de la sous-application n’est pas créé.

• Journal de débogage du module ASP.NET Core : Le fichier journal de l’application racine est créé et indique un fonctionnement normal. Le fichier journal de la sous-application n’est pas créé.

Résolution des problèmes :

Vérifiez que le fichier web.config de la sous-application n’inclut pas de section <handlers> ou que la sous-application n’hérite pas des gestionnaires de l’application parente.

La section <system.webServer> de l’application parente de web.config est placée à l’intérieur d’un élément <location>. La propriété InheritInChildApplications a la valeur false pour indiquer que les paramètres spécifiés dans l’élément <location> ne sont pas hérités par les applications situées dans un sous-répertoire de l’application parente. Pour plus d’informations, consultez Module ASP.NET Core (ANCM) pour IIS.

Chemin du journal stdout incorrect

• Navigateur : l’application répond normalement.

• Journal des applications : Impossible de démarrer la redirection de stdout dans C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll. Message d’exception : HRESULT 0x80070005 retourné sur {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84. Impossible d’arrêter la redirection de stdout dans C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll. Message d’exception : HRESULT 0x80070002 retourné sur {PATH}. Impossible de démarrer la redirection de stdout dans {CHEMIN}\aspnetcorev2_inprocess.dll.

• Journal stdout du module ASP.NET Core : Le fichier journal n’est pas créé.

• Journal de débogage du module ASP.NET Core : Impossible de démarrer la redirection de stdout dans C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll. Message d’exception : HRESULT 0x80070005 retourné sur {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84. Impossible d’arrêter la redirection de stdout dans C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll. Message d’exception : HRESULT 0x80070002 retourné sur {PATH}. Impossible de démarrer la redirection de stdout dans {CHEMIN}\aspnetcorev2_inprocess.dll.

Résolution des problèmes :

• Le chemin stdoutLogFile spécifié dans l’élément <aspNetCore> de web.config n’existe pas. Pour plus d’informations, consultez Module ASP.NET Core : Création et redirection de journaux.

• L’utilisateur du pool d’applications ne dispose pas d’un accès en écriture sur le chemin du journal stdout.

Problème général lié à la configuration d’application

• Navigateur : Erreur HTTP 500.0 - Échec du chargement du gestionnaire in-process ANCM --OU-- Erreur HTTP 500.30 - Échec du démarrage in-process d’ANCM

• Journal des applications : Variable

• Journal stdout du module ASP.NET Core : Le fichier journal est créé mais il est vide ou a été créé avec des entrées normales jusqu’au point d’échec de l’application.

• Journal de débogage du module ASP.NET Core : Variable

Résolution des problèmes :

Le processus n’a pas pu démarrer, probablement en raison d’un problème de configuration ou de programmation d’application.

Pour plus d'informations, voir les rubriques suivantes :

• Résoudre les problèmes liés à ASP.NET Core sur Azure App Service et IIS
• Résoudre les problèmes et effectuer le débogage des projets ASP.NET Core