Erreur : impossible de démarrer le débogage sur le serveur webError: Unable to Start Debugging on the Web Server

Lorsque vous essayez de déboguer une application ASP.NET exécutée sur un serveur Web, vous risquez d’obtenir ce message d’erreur : Unable to start debugging on the Web server.When you try to debug an ASP.NET application running on a Web server, you may get this error message: Unable to start debugging on the Web server.

Souvent, cette erreur se produit, car une modification de configuration ou d’erreur s’est produite et nécessite une mise à jour vos Pools d’applications, une réinitialisation d’IIS ou les deux.Often, this error occurs because an error or configuration change has occurred that requires an update to your Application Pools, an IIS reset, or both. Vous pouvez réinitialiser IIS en ouvrant une invite de commandes avec élévation de privilèges et en tapant iisreset.You can reset IIS by opening an elevated command prompt and typing iisreset.

Qu’est le message d’erreur détaillé ?What is the detailed error message?

Le Unable to start debugging on the Web server message est générique.The Unable to start debugging on the Web server message is generic. En règle générale, un message plus spécifique est inclus dans la chaîne d’erreur et qui peuvent vous aider à identifier la cause du problème ou de recherche pour une solution plus exacte.Usually, a more specific message is included in the error string and that may help you identify the cause of the problem or search for a more exact fix. Voici quelques exemples de messages d’erreur les plus courants sont ajoutées au message d’erreur principal :Here are a few of the more common error messages that are appended to the main error message:

IIS ne répertorie pas un site Web qui correspond le lancement urlIIS does not list a website that matches the launch url

  • Redémarrez Visual Studio en tant qu’administrateur et recommencez le débogage.Restart Visual Studio as an Administrator and retry debugging. (Certains scénarios de débogage ASP.NET nécessitent des privilèges élevés.)(Some ASP.NET debugging scenarios require elevated privileges.)

    Vous pouvez configurer Visual Studio exécute toujours en tant qu’administrateur en cliquant sur l’icône de raccourci de Visual Studio en choisissant Propriétés > Avancé, puis en choisissant soit toujours exécuté en tant qu’administrateur.You can configure Visual Studio to always run as an Administrator by right-clicking the Visual Studio shortcut icon, choosing Properties > Advanced, and then choosing to always run as an Administrator.

Le serveur web n’est pas configuré correctementThe web server is not configured correctly

Impossible de se connecter au serveur WebUnable to connect to the webserver

  • Vous êtes en cours d’exécution Visual Studio et le serveur Web sur le même ordinateur et le débogage à l’aide de F5 (au lieu de attacher au processus) ?Are you running Visual Studio and the Web server on the same machine and debugging using F5 (instead of Attach to Process)? Ouvrez les propriétés de votre projet et assurez-vous que le projet est configuré pour se connecter au serveur Web approprié et l’URL de lancement.Open your project properties and make sure that the project is configured to connect to the correct Web server and launch URL. (Ouvrez Propriétés > Web > serveurs ou Propriétés > déboguer en fonction de votre type de projet.(Open Properties > Web > Servers or Properties > Debug depending on your project type. Ouvrez un projet Web Forms Pages de propriétés > Options de démarrage > serveur.)For a Web Forms project, open Property Pages > Start Options > Server.)

  • Sinon, redémarrez votre Pool d’applications et réinitialisez IIS.Otherwise, restart your Application Pool and then reset IIS. Pour plus d’informations, consultez Vérifiez votre Configuration IIS.For more information, see Check your IIS Configuration.

Le serveur web n’a pas répondu en temps vouluThe web server did not respond in a timely manner

  • Réinitialiser IIS et recommencez le débogage.Reset IIS and retry debugging. Plusieurs instances du débogueur peuvent être attachés au processus IIS ; une réinitialisation y mette fin.Multiple debugger instances may be attached to the IIS process; a reset terminates them. Pour plus d’informations, consultez Vérifiez votre Configuration IIS.For more information, see Check your IIS Configuration.

Microsoft visual studio monitor(msvsmon.exe) du débogage distant ne semble pas être en cours d’exécution sur l’ordinateur distantThe microsoft visual studio remote debugging monitor(msvsmon.exe) does not appear to be running on the remote computer

  • Si vous effectuez un débogage sur un ordinateur distant, assurez-vous que vous disposez installés et exécutent le débogueur distant.If you are debugging on a remote machine, make sure you have installed and are running the remote debugger. Si le message mentionne un pare-feu, vérifiez que le corriger des ports dans le pare-feu sont ouverts, surtout si vous utilisez un pare-feu tiers.If the message mentions a firewall, make sure the correct ports in the firewall are open, especially if you are using a third party firewall.
  • Si vous utilisez un fichier d’hôtes, assurez-vous qu’il est configuré correctement.If you are using a HOSTS file, make sure it is configured correctly. Par exemple, si le débogage à l’aide F5 (au lieu de attacher au processus), les ordinateurs hôtes doit inclure la même URL de projet, comme dans les propriétés de votre projet, de fichiers Propriétés > Web > serveurs ou Propriétés > débogage, en fonction de votre type de projet.For example, if debugging using F5 (instead of Attach to Process), the HOSTS file needs to include the same project URL as in your project properties, Properties > Web > Servers or Properties > Debug, depending on your project type.

Le serveur distant a retourné une erreurThe remote server returned an error

Vérifiez votre fichier journal IIS pour sous-codes d’erreur et des informations supplémentaires et cette IIS 7 billet de blog.Check your IIS log file for error subcodes and additional information, and this IIS 7 blog post.

Voici en outre, certains des codes d’erreur courants et quelques suggestions.In addition, here are some of the common error codes and a few suggestions.

  • (403) interdit.(403) Forbidden. Il existe plusieurs causes possibles de cette erreur, vérifiez votre fichier journal et les paramètres de sécurité IIS pour le site web.There are many possible causes for this error, so check your log file and the IIS security settings for the web site. Assurez-vous que web.config du serveur inclut debug=true dans l’élément de compilation.Make sure the server's web.config includes debug=true in the compilation element. Assurez-vous que votre dossier d’Application Web possède les autorisations appropriées et que votre configuration de Pool d’applications est correcte (un mot de passe a peut-être été modifié).Make sure that your Web Application folder has the right permissions and that your Application Pool configuration is correct (a password may have changed). Consultez Vérifiez votre Configuration IIS.See Check your IIS Configuration. Si ces paramètres sont déjà corrects et que vous déboguez localement, vérifiez également que vous vous connectez pour le type de serveur correct et l’URL (dans Propriétés > Web > serveurs ou Propriétés > débogage, en fonction de votre type de projet).If these settings are already correct and you are debugging locally, also verify that you are connecting to the correct server type and URL (in Properties > Web > Servers or Properties > Debug, depending on your project type).
  • Serveur (503) non disponible.(503) Server Unavailable. Le Pool d’applications peut avoir arrêté en raison d’une modification de l’erreur ou la configuration.The Application Pool may have stopped due to an error or configuration change. Redémarrez le Pool d’applications.Restart the Application Pool.
  • (404) introuvable.(404) Not Found. Assurez-vous que le Pool d’applications est configuré pour la version correcte d’ASP.NET.Make sure that the Application Pool is configured for the correct version of ASP.NET.

Impossible de démarrer le débogage d’ASP.NETCould not start ASP.NET debugging

Le débogueur ne peut pas se connecter à l’ordinateur distantThe debugger cannot connect to the remote computer

Si vous effectuez un débogage localement, cette erreur peut se produire, car Visual Studio est une application 32 bits, de sorte qu’elle utilise la version 64 bits du débogueur distant pour déboguer des applications 64 bits.If you are debugging locally, this error may occur because Visual Studio is a 32-bit application, so it uses the 64-bit version of the remote debugger to debug 64-bit applications. Ouvrez les propriétés de votre projet et assurez-vous que le projet est configuré pour se connecter au serveur Web et URL correcte.Open your project properties and make sure that the project is configured to connect to the correct Web server and URL. (Ouvrez Propriétés > Web > serveurs ou Propriétés > déboguer en fonction de votre type de projet.)(Open Properties > Web > Servers or Properties > Debug depending on your project type.)

En outre, si vous utilisez un fichier d’hôtes, assurez-vous qu’il est configuré correctement.Also, if you are using a HOSTS file, make sure it is configured correctly. Par exemple, les ordinateurs hôtes du fichier doit inclure la même URL de projet, comme dans les propriétés de votre projet, Propriétés > Web > serveurs ou Propriétés > débogage, en fonction de votre type de projet.For example, the HOSTS file needs to include the same project URL as in your project properties, Properties > Web > Servers or Properties > Debug, depending on your project type.

Consultez l’aide pour les erreurs de configuration courantes.See help for common configuration errors. Exécution de la page Web en dehors du débogueur peut fournir davantage d’informations.Running the webpage outside of the debugger may provide further information.

  • Vous exécutez Visual Studio et le serveur Web sur le même ordinateur ?Are you running Visual Studio and the Web server on the same machine? Ouvrez les propriétés de votre projet et assurez-vous que le projet est configuré pour se connecter au serveur Web approprié et l’URL de lancement.Open your project properties and make sure that the project is configured to connect to the correct Web server and launch URL. (Ouvrez Propriétés > Web > serveurs ou Propriétés > déboguer en fonction de votre type de projet.)(Open Properties > Web > Servers or Properties > Debug depending on your project type.)

  • Si cela ne fonctionne pas ou si vous déboguez à distance, suivez les étapes de Vérifiez votre Configuration IIS.If that does not work or you are debugging remotely, follow steps in Check your IIS Configuration.

Vérifiez votre configuration d’IISCheck your IIS configuration

Après avoir suivi les étapes décrites ici pour résoudre le problème et avant de réessayer déboguer, vous devez également réinitialiser IIS.After taking steps detailed here to resolve the issue, and before trying again to debug, you may also need to reset IIS. C’est également en ouvrant une invite de commandes avec élévation de privilèges et en tapant iisreset.You can do that by opening an elevated command prompt and typing iisreset.

  • Arrêter et redémarrer vos Pools d’applications IIS, puis réessayez.Stop and restart your IIS Application Pools, then retry.

    Le Pool d’applications peut avoir arrêté suite à une erreur.The Application Pool may have stopped as a result of an error. Ou bien, une autre modification de configuration que vous avez apportées peut-être nécessiter que vous arrêtez et redémarrez le Pool d’applications.Or, another configuration change that you made may require that you stop and restart your Application Pool.

    Note

    Si le Pool d’applications conserve l’arrêt, vous devrez désinstaller le Module de réécriture d’URL à partir du panneau.If the Application Pool keeps stopping, you may need to uninstall the URL Rewrite Module from the Control Panel. Vous pouvez réinstaller à l’aide de Web Platform Installer (WebPI).You can reinstall it using the Web Platform Installer (WebPI). Ce problème peut se produire après une mise à niveau du système significatives.This issue may occur after a significant system upgrade.

  • Vérifiez votre configuration de Pool d’applications, corrigez-le si nécessaire, puis réessayez.Check your Application Pool configuration, correct it if needed, and then retry.

    Le Pool d’applications peut être configuré pour une version d’ASP.NET qui ne correspond pas à votre projet Visual Studio.The Application Pool may be configured for a version of ASP.NET that does not match your Visual Studio project. Mettre à jour la version d’ASP.NET dans le Pool d’applications et le redémarrer.Update the ASP.NET version in the Application Pool and restart it. Pour plus d’informations, consultez IIS 8.0 à l’aide de ASP.NET 3.5 et ASP.NET 4.5.For detailed information, see IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5.

    En outre, si les informations d’identification de mot de passe ont été modifiés, vous devrez peut-être mettre à jour dans votre Pool d’applications ou le site Web.Also, if password credentials have changed, you may need to update them in your Application Pool or Web site. Dans le Pool d’applications, mettre à jour les informations d’identification dans paramètres avancés > modèle de processus > identité.In the Application Pool, update credentials in Advanced Settings > Process Model > Identity. Pour le site Web, mettre à jour les informations d’identification dans les paramètres de base > se connecter en tant que... . Redémarrez votre Pool d’applications.For the Web site, update credentials in Basic Settings > Connect as.... Restart your Application Pool.

  • Vérifiez que votre dossier d’Application Web possède les autorisations appropriées.Check that your Web Application folder has the right permissions.

    Assurez-vous que vous donnez IIS_IUSRS, IUSR, ou associé à l’utilisateur spécifique le Pool d’applications lecture et d’exécution de droits pour le dossier d’Application Web.Make sure that you give IIS_IUSRS, IUSR, or the specific user associated with the Application Pool read and execute rights for the Web Application folder. Corrigez le problème et redémarrez le Pool d’applications.Fix the issue and restart your Application Pool.

  • Assurez-vous que la version correcte d’ASP.NET est installée sur IIS.Make sure that the correct version of ASP.NET is installed on IIS.

    Versions incompatibles de ASP.NET sur IIS et dans votre projet Visual Studio peuvent provoquer ce problème.Mismatched versions of ASP.NET on IIS and in your Visual Studio project may cause this issue. Vous devrez peut-être définir la version du framework dans le fichier web.config. Pour installer ASP.NET sur IIS, utilisez le Web Platform Installer (WebPI).You may need to set the framework version in web.config. To install ASP.NET on IIS, use the Web Platform Installer (WebPI). Consultez également IIS 8.0 à l’aide de ASP.NET 3.5 et ASP.NET 4.5 ou, pour ASP.NET Core, hôte sous Windows avec IIS.Also, see IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5 or, for ASP.NET Core, Host on Windows with IIS.

  • Résoudre les erreurs d’authentification si vous utilisez uniquement l’adresse IPResolve authentication errors if you are using only the IP address

    Par défaut, les adresses IP sont supposées faire partie d'Internet et l'authentification NTLM ne s'effectue pas via Internet.By default, IP addresses are assumed to be part of the Internet, and NTLM authentication is not done over the Internet. Si votre site web est configuré dans IIS pour exiger une authentification, cette authentification échoue.If your web site is configured in IIS to require authentication, this authentication fails. Pour corriger ce problème, vous pouvez spécifier le nom de l’ordinateur distant au lieu de l’adresse IP.To correct this problem, you can specify the name of the remote computer instead of the IP address.

Les autres causesOther causes

Si la configuration d’IIS ne pose pas de problème, essayez les étapes suivantes :If the IIS configuration is not causing the issue, try these steps:

  • Redémarrez Visual Studio avec des privilèges d’administrateur, puis réessayez.Restart Visual Studio with Administrator privileges and try again.

    Certains scénarios de débogage ASP.NET telles que l’utilisation de Web Deploy requièrent des privilèges élevés pour Visual Studio.Some ASP.NET debugging scenarios such as using Web Deploy require elevated privileges for Visual Studio.

  • Si vous exécutent plusieurs instances de Visual Studio, rouvrez votre projet dans une instance de Visual Studio (avec des privilèges d’administrateur), puis réessayez.If multiple instances of Visual Studio are running, reopen your project in one instance of Visual Studio (with Administrator privileges), and try again.

  • Si vous utilisez un fichier d’hôtes avec les adresses locales, essayez d’utiliser l’adresse de bouclage au lieu de l’adresse IP de l’ordinateur.If you are using a HOSTS file with local addresses, try using the loopback address instead of the machine's IP address.

    Si vous n’utilisez pas les adresses locales, assurez-vous que votre fichier HOSTS inclut la même URL de projet, comme dans les propriétés de votre projet, Propriétés > Web > serveurs ou Propriétés > débogage, en fonction de votre type de projet.If you are not using local addresses, make sure your HOSTS file includes the same project URL as in your project properties, Properties > Web > Servers or Properties > Debug, depending on your project type.

Étapes de dépannage supplémentairesMore troubleshooting steps

  • Afficher la page localhost dans le navigateur sur le serveur.Bring up the localhost page in the browser on the server.

    Si IIS n’est pas installé correctement, vous devez obtenir des erreurs quand vous tapez http://localhost dans un navigateur.If IIS is not installed correctly, you should get errors when you type http://localhost in a browser.

    Pour plus d’informations sur le déploiement sur IIS, consultez IIS 8.0 à l’aide de ASP.NET 3.5 et ASP.NET 4.5 et, pour ASP.NET Core, hôte sous Windows avec IIS.For more information on deploying to IIS, see IIS 8.0 Using ASP.NET 3.5 and ASP.NET 4.5 and, for ASP.NET Core, Host on Windows with IIS.

  • Créer une application ASP.NET de base sur le serveur (ou utilisez un fichier web.config de base).Create a basic ASP.NET application on the server (or use a basic web.config file).

    Si vous ne peut pas obtenir votre application pour travailler avec le débogueur, essayez de créer une application ASP.NET de base localement sur le serveur et essayez de déboguer l’application de base.If you can't get your app to work with the debugger, try creating a basic ASP.NET application locally on the server, and try to debug the basic app. (Il pourrez que vous souhaitez utiliser le modèle ASP.NET MVC par défaut.) Si vous pouvez déboguer une application de base, qui peut vous aider à identifier quelle est la différence entre les deux configurations.(You might want to use the default ASP.NET MVC template.) If you can debug a basic app, that may help you identify what's different between the two configurations. Rechercher les différences dans les paramètres dans le fichier web.config, telles que les règles de réécriture d’URL.Look for differences in settings in the web.config file, such as URL rewrite rules.

Voir aussiSee Also

Débogage d’applications web : erreurs et dépannageDebugging Web Applications: Errors and Troubleshooting