Impossible de démarrer le débogage sur le serveur web : 7 causes

Le message « Impossible de démarrer le débogage sur le serveur web » signifie que Visual Studio n’a pas réussi à attacher son débogueur au serveur qui héberge le projet : IIS en local ou le débogueur distant sur une autre machine. Le message secondaire qui l’accompagne désigne presque toujours la cause. Cet article passe en revue les causes à vérifier dans l’ordre, des droits et de la configuration d’IIS jusqu’au débogage distant.

Lire le message secondaire de l’erreur Visual Studio

Le message principal est générique. La suite du texte indique où chercher : « IIS does not list a website that matches the launch url » pointe vers les droits ou l’adresse du projet, « The web server is not configured correctly » vers la configuration du site, « The operation has timed out » vers un processus déjà occupé, et « msvsmon.exe does not appear to be running » vers le débogage distant.

Lire également : Pourquoi opter pour le tls sécurisé pour protéger son site web

Avant de modifier quoi que ce soit, ouvrez l’URL du projet dans un navigateur, hors de Visual Studio. L’erreur HTTP affichée (403, 404, 503) oriente le diagnostic mieux que le message du débogueur.

IIS, ASP.NET et droits d’administrateur

Certains scénarios de débogage ASP.NET demandent des privilèges élevés. Fermez Visual Studio et relancez-le en administrateur, puis réessayez. Si plusieurs instances sont ouvertes, rouvrez le projet dans une seule, lancée en administrateur.

A découvrir également : Optimiser le stockage des données web avec des pratiques efficaces

Vérifiez ensuite qu’IIS est bien installé : la page http://localhost doit s’afficher dans le navigateur du serveur. La version d’ASP.NET installée sur IIS doit aussi correspondre à celle du projet, ce qui peut obliger à fixer la version du framework dans le web.config. Pour un projet qui s’appuie sur un framework de développement web, c’est le premier réglage à contrôler. Après chaque correction, ouvrez une invite de commandes élevée et lancez iisreset.

Pool d’applications IIS arrêté ou mal réglé

Un pool arrêté provoque une erreur 503 : redémarrez-le dans le gestionnaire IIS. Une erreur 404 signale plutôt un pool réglé sur une version d’ASP.NET qui ne correspond pas au projet.

L’identité du pool compte aussi. Si un mot de passe a changé, mettez-le à jour dans les paramètres avancés du pool, rubrique Process Model, puis Identity. Cette identité doit disposer des droits de lecture et d’exécution sur le dossier de l’application : donnez-les à IIS_IUSRS, à IUSR ou à l’utilisateur du pool. Si l’application se connecte à une base de données de l’application, vérifiez que ce même compte y a accès.

Avec Visual Studio 2019 ou une version antérieure, qui sont des applications 32 bits, l’option Enable 32-bit applications du pool doit passer à true pour déboguer en local une application 64 bits.

Gestionnaire IIS affichant la liste des pools d'applications d'un serveur

Si le pool s’arrête de lui-même, le module URL Rewrite est un coupable connu : Microsoft conseille de le désinstaller puis de le réinstaller, un problème qui peut survenir après une mise à niveau importante du système.

URL du projet, liaisons IIS et fichier hosts

L’adresse de lancement du projet doit correspondre au site IIS. Ouvrez les propriétés du projet (Properties, Web, Servers, ou Debug selon le type de projet) et contrôlez le type de serveur et l’URL. Si l’adresse est incorrecte et que le serveur externe n’est pas nécessaire, choisir IIS Express permet de repartir sur une base saine.

Quand le projet utilise un nom d’hôte personnalisé, le fichier hosts doit contenir exactement la même URL que celle des propriétés. Si vous utilisez des adresses locales, essayez l’adresse de bouclage plutôt que l’adresse IP de la machine. Une liaison HTTPS suppose en plus un certificat TLS du site valide.

Authentification et web.config : debug= »true » et erreur 403

Une erreur 403 a plusieurs causes possibles : consultez le journal IIS et les paramètres de sécurité du site. Le web.config du serveur doit contenir debug= »true » dans l’élément compilation, sinon le débogueur ne peut pas s’attacher.

Ce réglage saute facilement : un profil de publication en Release le remet à false. Republiez en Debug, vérifiez le fichier, puis réinitialisez IIS.

L’authentification joue aussi. Quand le site exige une authentification et que vous vous connectez par adresse IP, elle échoue : l’authentification NTLM n’est pas faite pour les adresses considérées comme Internet. Utilisez le nom de la machine à la place.

Si le web.config contient des règles de réécriture d’URL, testez avec un fichier minimal sans elles : elles provoquent les erreurs « Could not start ASP.NET debugging » et « Operation not supported ».

Débogage distant : msvsmon, ports et pare-feu

Sur une machine distante, le débogueur distant doit être installé et lancé avant de démarrer le débogage, et sa version doit correspondre à Visual Studio. Il écoute par défaut sur le port 4026 pour Visual Studio 2022 et 4024 pour Visual Studio 2019. Sur un système 64 bits, le débogage d’un processus 32 bits passe en général par le port 4025.

Ouvrez ces ports dans le pare-feu, y compris un pare-feu tiers. Le port UDP 3702 sert seulement à découvrir les débogueurs du réseau et reste facultatif si vous connaissez le nom de la machine. Pour changer de port, lancez msvsmon avec l’option /port.

Deux ordinateurs reliés en réseau dans un bureau, l'un servant de serveur de test

Contourner l’erreur pour continuer à travailler

Si aucune correction ne suffit, créez un projet ASP.NET de base sur le serveur et essayez de le déboguer : en comparant les deux, les différences de web.config apparaissent, par exemple les règles de réécriture. Pendant ce temps, IIS Express permet de continuer à développer en local.

Si le débogueur refuse de s’attacher, un message « The web server did not respond in a timely manner » indique qu’un autre débogueur occupe peut-être le processus : un iisreset les termine tous. Une fois l’erreur levée, il reste à mesurer la performance du site sur le serveur réel.

La plupart des échecs viennent d’un pool arrêté, d’un droit manquant ou d’un debug= »true » perdu à la publication, et se règlent en quelques minutes une fois le message secondaire lu.