Freigeben über

Fehler: Das Debuggen kann auf dem Webserver nicht gestartet werden

  • Artikel

Beim Versuch, eine ASP.NET-Anwendung zu debuggen, die auf einem Webserver ausgeführt wird, kann eventuell die folgende Fehlermeldung angezeigt werden: Unable to start debugging on the Web server.

Oft tritt dieser Fehler auf, da ein Fehler zurückgegeben oder eine Konfigurationsänderung durchgeführt wurde, die ein Update für Ihre Anwendungspools, eine IIS-Zurücksetzung oder beides erfordert. Sie können die IIS zurücksetzen, indem Sie eine Eingabeaufforderung mit erhöhten Rechten öffnen und iisreset eingeben.

Was lautet die ausführliche Fehlermeldung?

Die Meldung Unable to start debugging on the Web server ist generisch. In der Regel ist in der Fehlerzeichenfolge eine genauere Meldung enthalten, die Ihnen helfen kann, die Ursache des Problems zu identifizieren oder nach einer genaueren Lösung zu suchen. Im folgenden finden Sie einige der häufigsten Fehlermeldungen, die an die Hauptfehlermeldung angefügt werden:

Die IIS führen eine Website nicht auf, die der Start-URL entspricht

  • Starten Sie Visual Studio neu als Administrator, und versuchen Sie, das Debuggen zu wiederholen. (Für manche ASP.NET-Debugszenarios sind erhöhte Rechte erforderlich.)

    Sie können Visual Studio so konfigurieren, dass der Dienst immer mit der Administratorrolle ausgeführt wird, indem Sie mit der rechten Maustaste auf das Verknüpfungssymbol für Visual Studio klicken, dann auf Eigenschaften > Erweitert klicken und dann die Option auswählen, dass der Dienst immer mit der Administratorrolle ausgeführt wird.

Der Webserver ist nicht richtig konfiguriert

Die Verbindung mit dem Webserver konnte nicht hergestellt werden

  • Führen Sie Visual Studio und den Webserver auf demselben Computer aus, und debuggen Sie mithilfe von F5 (anstelle von An Prozess anhängen)? Öffnen Sie die Projekteigenschaften, und vergewissern Sie sich, dass das Projekt so konfiguriert ist, dass es eine Verbindung zum richtigen Webserver und zur Start-URL herstellt. (Öffnen Sie je nach Ihrem Projekttyp Eigenschaften > Web > Server oder Eigenschaften > Debuggen. Für ein Web Forms-Projekt öffnen Sie Eigenschaftenseiten > Startoptionen > Server.)

  • Starten Sie Ihren Anwendungspool andernfalls neu, und setzen Sie dann die IIS zurück. Weitere Informationen erhalten Sie unter Überprüfen der IIS-Konfiguration.

Der Webserver hat nicht rechtzeitig reagiert

  • Setzen Sie die IIS zurück, und versuchen Sie, das Debuggen zu wiederholen. Möglicherweise sind an den IIS-Prozess mehrere Debuggerinstanzen angefügt. Wenn Sie ein Zurücksetzungsvorgang durchführen, werden diese beendet. Weitere Informationen erhalten Sie unter Überprüfen der IIS-Konfiguration.

Timeout bei Vorgang

  • Setzen Sie die IIS zurück, und versuchen Sie, das Debuggen zu wiederholen. Möglicherweise sind an den IIS-Prozess mehrere Debuggerinstanzen angefügt. Wenn Sie ein Zurücksetzungsvorgang durchführen, werden diese beendet. Weitere Informationen erhalten Sie unter Überprüfen der IIS-Konfiguration.

Der Microsoft Visual Studio-Remotedebugmonitor (msvsmon.exe) wird auf dem Remotecomputer nicht ausgeführt

  • Wenn Sie das Debuggen auf einem Remotecomputer ausführen, vergewissern Sie sich, dass der Remotedebugger installiert ist und ausgeführt wird. Wenn in der Meldung eine Firewall erwähnt wird, überprüfen Sie, ob die richtigen Ports in der Firewall geöffnet sind, besonders dann, wenn Sie eine Firewall eines Drittanbieters verwenden.
  • Wenn Sie eine HOSTS-Datei verwenden, überprüfen Sie, ob sie ordnungsgemäß konfiguriert ist. Wenn Sie beispielsweise mithilfe von F5 (anstelle von An Prozess anhängen) debuggen, muss die HOSTS-Datei dieselbe Projekt-URL enthalten, die auch in den Projekteigenschaften enthalten ist: Je nach Projekttyp finden Sie sie unter Eigenschaften > Web > Server oder Eigenschaften > Debuggen.

Der Remoteserver hat einen Fehler zurückgegeben

Sehen Sie in Ihrer IIS-Protokolldatei nach, ob untergeordneter Fehlercode und weitere Informationen enthalten sind. Sehen Sie sich außerdem diesen IIS 7-Blogbeitrag an.

Außerdem finden Sie hier einige häufig auftretende Fehlercodes und einige Vorschläge dazu.

  • (403) Unzulässig. Für diesen Fehler gibt es viele verschiedene Gründe. Suchen Sie in der Protokolldatei und den IIS-Sicherheitseinstellungen für die Website nach möglichen Ursachen. Sorgen Sie dafür, dass die web.config-Datei des Servers im Kompilierungselement debug=true enthält. Vergewissern Sie sich, dass Ihr Webanwendungsordner über die erforderlichen Berechtigungen verfügt und dass die Konfiguration Ihres Anwendungspools korrekt ist. Möglicherweise wurde ein Kennwort geändert. Weitere Informationen finden Sie unter Überprüfen der IIS-Konfiguration. Wenn diese Einstellungen korrekt sind und Sie lokal debuggen, überprüfen Sie außerdem, ob Sie eine Verbindung zum richtigen Servertyp und der korrekten URL herstellen. Je nach Projekttyp finden Sie diese Informationen unter Eigenschaften > Web > Server oder Eigenschaften > Debuggen.
  • (503) Server nicht verfügbar. Möglicherweise wurde der Anwendungspool aufgrund eines Fehlers oder einer Konfigurationsänderung angehalten. Starten Sie den Anwendungspool neu.
  • (404) Nicht gefunden. Überprüfen Sie, ob der Anwendungspool mit der richtigen ASP.NET-Version konfiguriert wurde.

Das ASP.NET-Debuggen konnte nicht gestartet werden

  • Starten Sie den Anwendungspool neu, und setzen Sie die IIS zurück. Weitere Informationen erhalten Sie unter Überprüfen der IIS-Konfiguration.
  • Wenn Sie URL-Umschreibungen durchführen, testen Sie eine einfache web.config-Datei ohne URL-Umschreibungen. Sehen Sie sich unter Überprüfen der IIS-Konfiguration den Hinweis zum URL-Rewrite-Modul an.

Der Debugger kann keine Verbindung zum Remotecomputer herstellen

Wenn Sie lokal debuggen, öffnen Sie die Projekteigenschaften in Visual Studio und vergewissern Sie sich, dass das Projekt so konfiguriert ist, dass eine Verbindung zum richtigen Webserver und zur korrekten URL hergestellt wird. (Öffnen Sie ja nach Projekttyp Eigenschaften > Web > Server oder Eigenschaften > Debuggen.)

Dieser Fehler kann beim lokalen Debuggen mit einer 32-Bit-Version von Visual Studio auftreten, bei der die 64-Bit-Version des Remotedebuggers verwendet wird, um 64-Bit-Anwendungen zu debuggen. Visual Studio 2019 und früher sind 32-Bit-Anwendungen. Überprüfen Sie Ihren Anwendungspool in den IIS, um dafür zu sorgen, dass 32-Bit-Anwendungen aktivieren auf true festgelegt ist. Starten Sie die IIS dann neu, und versuchen Sie es noch mal.

Wenn Sie eine HOSTS-Datei verwenden, überprüfen Sie, ob sie ordnungsgemäß konfiguriert ist. Die HOSTS-Datei muss beispielsweise dieselbe Projekt-URL enthalten, die auch in den Projekteigenschaften enthalten ist: Je nach Projekttyp finden Sie sie unter Eigenschaften > Web > Server oder Eigenschaften > Debuggen.

In der Hilfe sind häufige Konfigurationsfehler erläutert. Möglicherweise erhalten Sie weitere Informationen, wenn Sie die Webseite außerhalb des Debuggers ausführen.

  • Führen Sie Visual Studio und den Webserver auf demselben Computer aus? Öffnen Sie die Projekteigenschaften, und vergewissern Sie sich, dass das Projekt so konfiguriert ist, dass es eine Verbindung zum richtigen Webserver und zur Start-URL herstellt. (Öffnen Sie ja nach Projekttyp Eigenschaften > Web > Server oder Eigenschaften > Debuggen.)

  • Wenn dies nicht funktioniert oder Sie ein Remotedebugging durchführen, befolgen Sie die Schritte unter Überprüfen der IIS-Konfiguration.

Vorgang wird nicht unterstützt. Unbekannter Fehler: Fehlernummer

Wenn Sie URL-Umschreibungen durchführen, testen Sie eine einfache web.config-Datei ohne URL-Umschreibungen. Sehen Sie sich unter Überprüfen der IIS-Konfiguration den Hinweis zum URL-Rewrite-Modul an.

Überprüfen der IIS-Konfiguration

Unter Umständen müssen Sie auch IIS zurücksetzen, nachdem Sie die hier aufgeführten Problembehandlungsschritte ausgeführt haben und bevor Sie das Debugging noch mal versuchen. Öffnen Sie hierzu eine Administratoreingabeaufforderung mit erhöhten Rechten, und geben Sie iisreset ein.

  • Stoppen Sie Ihre IIS-Anwendungspools, und starten Sie sie neu, und versuchen Sie es dann noch mal.

    Aufgrund eines Fehlers wurde der Anwendungspool möglicherweise angehalten. Möglicherweise erfordert es auch eine andere Konfigurationsänderung, die Sie vorgenommen haben, dass Sie Ihren Anwendungspool anhalten und neu starten.

    Hinweis

    Wenn der Anwendungspool weiterhin angehalten wird, müssen Sie möglicherweise das URL-Rewrite-Modul über die Systemsteuerung deinstallieren und dann das Modul neu installieren. Dieses Problem tritt möglicherweise nach einem umfassenden Systemupgrade auf.

  • Überprüfen Sie die Konfiguration des Anwendungspools, korrigieren Sie sie gegebenenfalls, und versuchen Sie es dann noch mal.

    Der Anwendungspool wurde möglicherweise für eine ASP.NET-Version konfiguriert, die nicht mit Ihrem Visual Studio-Projekt übereinstimmt. Aktualisieren Sie die ASP.NET-Version im Anwendungspool, und starten Sie ihn dann neu. Detaillierte Informationen finden Sie unter IIS 8.0 mit ASP.NET 3.5 und ASP.NET 4.5.

    Wenn das Kennwort der Anmeldeinformationen geändert wurde, müssen Sie sie möglicherweise in Ihrem Anwendungspool oder auf der Website ebenfalls aktualisieren. Aktualisieren Sie Anmeldeinformationen im Anwendungspool über Erweiterte Einstellungen > Prozessmodell > Identität. Aktualisieren Sie für die Website die Anmeldedaten in den Grundeinstellungen > Verbinden als.... Starten Sie Ihren Anwendungspool neu.

  • Überprüfen Sie, ob Ihr Webanwendungsordner die erforderlichen Berechtigungen aufweist.

    Geben Sie IIS_IUSRS, IUSR oder dem spezifischen Benutzer, der dem Anwendungspool zugeordnet ist, Lese- und Ausführungsrechte für den Webanwendungsordner. Beheben Sie das Problem, und starten Sie Ihren Anwendungspool neu.

  • Stellen Sie sicher, dass in den IIS die richtige ASP.NET-Version installiert ist.

    Das Problem kann durch nicht übereinstimmende Versionen von ASP.NET in IIS und in Ihrem Visual Studio-Projekt verursacht werden. Möglicherweise müssen Sie die Frameworkversion in „web.config“ festlegen. Informationen zum Installieren von ASP.NET Core unter IIS finden Sie unter Installieren von ASP.NET Core unter Windows Server. Informationen zu ASP.NET finden Sie unter Installieren ASP.NET unter Windows Server. Weitere Informationen finden Sie unter IIS 8.0: Verwenden von ASP.NET 3.5 und ASP.NET 4.5. Lesen Sie bei Verwendung von ASP.NET Core die Informationen unter Hosten von ASP.NET Core unter Windows mit IIS.

  • Beheben Sie Authentifizierungsfehler, wenn Sie nur die IP-Adresse verwenden

    Standardmäßig wird davon ausgegangen, dass IP-Adressen dem Internet zuzuordnen sind, während die NTLM-Authentifizierung nicht über das Internet vorgenommen wird. Wenn Ihre Website in den IIS so konfiguriert wurde, dass eine Authentifizierung erforderlich ist, schlägt die Authentifizierung fehl. Zur Behebung dieses Problems können Sie den Namen des Remotecomputers anstelle der IP-Adresse angeben.

Weitere Ursachen

Wenn die IIS-Konfiguration das Problem nicht verursacht, können Sie die folgenden Schritte testen:

  • Starten Sie Visual Studio mit Administratorberechtigungen neu, und versuchen Sie es noch mal.

    Für manche ASP.NET-Debugszenarien sind erhöhte Rechte für Visual Studio erforderlich.

  • Wenn mehrere Visual Studio-Instanzen ausgeführt werden, öffnen Sie Ihr Projekt in einer Visual Studio-Instanz (mit Administratorberechtigungen) neu, und versuchen Sie es noch mal.

  • Wenn Sie eine HOSTS-Datei mit lokalen Adressen verwenden, versuchen Sie es mit der Loopbackadresse anstelle der IP-Adresse des Computers.

    Wenn Sie keine lokalen Adressen verwenden, sorgen Sie dafür, dass Ihre HOSTS-Datei dieselbe Projekt-URL einschließt, die auch in Ihren Projekteigenschaften enthalten ist. Je nach Projekttyp finden Sie sie unter Eigenschaften > Web > Server oder Eigenschaften > Debuggen.

Weitere Schritte zur Problembehandlung

  • Öffnen Sie die localhost-Seite im Browser auf dem Server.

    Wenn IIS nicht ordnungsgemäß installiert wurde, sollten Fehler angezeigt werden, wenn Sie http://localhost in einem Browser eingeben.

    Weitere Informationen zur Bereitstellung in den IIS finden Sie unter IIS 8.0 mit ASP.NET 3.5 und ASP.NET 4.5 und für ASP.NET Core unter Hosten von ASP.NET Core unter Windows mit IIS.

  • Erstellen Sie eine grundlegende ASP.NET-Anwendung auf dem Server, oder verwenden Sie eine grundlegende web.config-Datei.

    Wenn Sie es nicht ermöglichen können, dass die App mit dem Debugger verwendet werden kann, versuchen Sie, eine grundlegende ASP.NET-Anwendung lokal auf dem Server zu erstellen, und versuchen Sie, die grundlegende App zu debuggen. (Sie sollten die Standard-ASP.NET-MVC-Vorlage verwenden.) Wenn Sie eine grundlegende App debuggen können, können Sie darüber möglicherweise herausfinden, wo der Unterschied zwischen den beiden Konfigurationen liegt. Suchen Sie in den Einstellungen der web.config-Datei nach Unterschieden, z. B. bei den URL-Umschreibungsregeln.

Weitere Informationen