Compartilhar via

Erro: não foi possível iniciar a depuração no servidor Web

  • Artigo

Quando você tenta depurar um aplicativo ASP.NET em execução em um servidor Web, pode receber essa mensagem de erro: Unable to start debugging on the Web server.

Geralmente, esse erro ocorre porque ocorreu um erro ou uma alteração de configuração que requer uma atualização para seus Pools de Aplicativos, uma redefinição do IIS ou ambos. Você pode redefinir o IIS abrindo um prompt de comando com privilégios elevados e digitando iisreset.

O que é a mensagem de erro detalhada?

A mensagem Unable to start debugging on the Web serveré genérica. Normalmente, uma mensagem mais específica é incluída na cadeia de caracteres de erro e isso pode ajudá-lo a identificar a causa do problema ou pesquisar uma correção mais exata. Eis algumas das mensagens de erro mais comuns que são acrescentadas à mensagem de erro principal:

O IIS não lista um site que corresponda à URL de inicialização

  • Reinicie o Visual Studio como administrador e tente depurar novamente. (Alguns cenários de depuração de ASP.NET exigem privilégios elevados.)

    Você pode configurar o Visual Studio para sempre ser executado como administrador clicando com o botão direito do mouse no ícone de atalho do Visual Studio, escolhendo Propriedades > Avançadas e, em seguida, optando por sempre executar como administrador.

O servidor Web não foi configurado corretamente

Não é possível conectar-se ao servidor Web

  • Você está executando o Visual Studio e o servidor Web no mesmo computador e depurando usando F5 (em vez de Anexar ao Processo)? Abra as propriedades do projeto e verifique se o projeto está configurado para se conectar ao servidor Web correto e URL de inicialização. (Abra Propriedades > Servidores Web > ou Propriedades > Depuração dependendo do tipo de projeto. Para um projeto Web Forms, abra Páginas de Propriedades > Opções Iniciais > Servidor.)

  • Caso contrário, reinicie o Pool de Aplicativos e redefina o IIS. Para saber mais, confira Verificar sua configuração do IIS.

O servidor Web não respondeu em tempo hábil

  • Redefinir o IIS e tentar novamente a depuração. Várias instâncias do depurador podem ser anexadas ao processo do IIS; uma redefinição os encerra. Para saber mais, confira Verificar sua configuração do IIS.

O tempo limite da operação foi atingido

  • Redefinir o IIS e tentar novamente a depuração. Várias instâncias do depurador podem ser anexadas ao processo do IIS; uma redefinição os encerra. Para saber mais, confira Verificar sua configuração do IIS.

O Monitor de Depuração Remota do Microsoft Visual Studio (MSVSMON.EXE) parece não estar sendo executado no computador remoto

  • Se você estiver depurando em um computador remoto, verifique se instalou e está executando o depurador remoto. Se a mensagem mencionar um firewall, verifique se as portas corretas no firewall estão abertas, especialmente se você estiver usando um firewall de terceiros.
  • Se você estiver usando um arquivo HOSTS, verifique se ele está configurado corretamente. Por exemplo, se está depurando usando F5 (em vez de Anexar ao Processo), o arquivo HOSTS precisará incluir a mesma URL de projeto que as propriedades do projeto, Propriedades > Web > Servidores ou Propriedades> Depuração, dependendo do tipo de projeto.

O servidor remoto retornou um erro

Verifique o arquivo de log do IIS em busca de subcódigos de erro e informações adicionais e esta postagem no blog do IIS 7.

Além disso, aqui estão alguns dos códigos de erro comuns e algumas sugestões.

  • (403) Proibido. Há muitas causas possíveis para esse erro, portanto, verifique o arquivo de log e as configurações de segurança do IIS para o site. Verifique se o arquivo web.config do servidor inclui debug=true no elemento de compilação. Verifique se a pasta Aplicativo Web tem as permissões certas e se a configuração do Pool de Aplicativos está correta (uma senha pode ter sido alterada). Confira Verificar a configuração do IIS. Se essas configurações já estiverem corretas e você estiver depurando localmente, verifique também se você está se conectando ao tipo de servidor e à URL corretos (em Propriedades > Web > Servidores ou Propriedades > Depuração, dependendo do tipo de projeto).
  • (503) Servidor não disponível. O pool de aplicativos pode ter parado devido a um erro ou alteração de configuração. Reinicie o pool de aplicativos.
  • (404) Não encontrado. Verifique se o pool de aplicativos está configurado para a versão correta do ASP.NET.

Não foi possível iniciar a depuração de ASP.NET

O depurador não pode se conectar ao computador remoto

Se você estiver depurando localmente, abra as propriedades do projeto no Visual Studio e verifique se o projeto está configurado para se conectar ao servidor Web e à URL corretos. (Abra Propriedades > Web > Servidores ou Propriedades > Depuração, dependendo do tipo de projeto.)

Esse erro pode ocorrer ao depurar localmente com uma versão de 32 bits do Visual Studio, que usa a versão de 64 bits do depurador remoto para depurar aplicativos de 64 bits. O Visual Studio 2019 e anteriores são aplicativos de 32 bits. Verifique o pool de aplicativos no IIS para verificar se Habilitar aplicativos de 32 bits está definido como true, reinicie o IIS e tente novamente.

Além disso, se você estiver usando um arquivo HOSTS, verifique se ele está configurado corretamente. Por exemplo, o arquivo HOSTS precisa incluir a mesma URL de projeto que nas propriedades do projeto, Propriedades > Web > Servidores ou Propriedades > Depuração , dependendo do tipo de projeto.

Consulte a ajuda para obter os erros de configuração comuns. A execução da página da Web fora do depurador pode fornecer mais informações.

  • Você está executando o Visual Studio e o servidor Web no mesmo computador? Abra as propriedades do projeto e verifique se o projeto está configurado para se conectar ao servidor Web correto e URL de inicialização. (Abra Propriedades > Web > Servidores ou Propriedades > Depuração, dependendo do tipo de projeto.)

  • Se isso não funcionar ou se você estiver depurando remotamente, execute as etapas em Verificar a Configuração do IIS.

Operação sem suporte. Erro desconhecido: número do erro

Se estiver fazendo reescritas de URL, teste um arquivo web.config básico sem reescritas de URL. Confira a Observação sobre o Módulo de Reescrita de URL em Verificar a configuração do IIS.

Verificar a configuração do IIS

Depois de executar as etapas detalhadas aqui para resolver o problema e antes de tentar novamente depurar, talvez você também precise redefinir o IIS. Você pode fazer isso abrindo um prompt de comando com privilégios elevados e digitando iisreset.

  • Pare e reinicie os pools de aplicativos do IIS e tente novamente.

    O pool de aplicativos pode ter parado como resultado de um erro. Ou outra alteração de configuração que você fez pode exigir que você interrompa e reinicie o pool de aplicativos.

    Observação

    Se o Pool de Aplicativos continuar parando, talvez seja necessário desinstalar o Módulo de Reescrita de URL do Painel de Controle e reinstalar o módulo. Esse problema pode ocorrer após uma atualização significativa do sistema.

  • Verifique a configuração do Pool de Aplicativos, corrija-a, se necessário, e tente novamente.

    O Pool de Aplicativos pode estar configurado para uma versão do ASP.NET que não corresponde ao projeto do Visual Studio. Atualize a versão ASP.NET no Pool de Aplicativos e reinicie-a. Para obter informações detalhadas, confira IIS 8.0 usando ASP.NET 3.5 e ASP.NET 4.5.

    Além disso, se as credenciais de senha tiverem sido alteradas, talvez seja necessário atualizá-las no pool de aplicativos ou no site da Web. No pool de aplicativos, atualize as credenciais em Configurações Avançadas > Modelo de Processo > Identidade. Para o site, atualize as credenciais em Configurações Básicas > Conectar como.... Reinicie o pool de aplicativos.

  • Verifique se a pasta Aplicativo Web tem as permissões corretas.

    Forneça a IIS_IUSRS, IUSR ou ao usuário específico associado ao Pool de Aplicativos os direitos de leitura e execução para a pasta Aplicativo Web. Corrija o problema e reinicie o pool de aplicativos.

  • Verifique se a versão correta do ASP.NET está instalada no IIS.

    Versões incompatíveis do ASP.NET no IIS e no projeto do Visual Studio podem causar esse problema. Talvez seja necessário definir a versão da estrutura em web.config. Para instalar ASP.NET Core no IIS, confira Instalar ASP.NET Core no Windows Server ou, para ASP.NET, Instalar ASP.NET no Windows Server. Além disso, confira IIS 8.0 Usando ASP.NET 3.5 e ASP.NET 4.5 ou, para ASP.NET Core, Host no Windows com IIS.

  • Resolver erros de autenticação se você estiver usando apenas o endereço IP

    Por padrão, os endereços IP devem fazer parte da Internet e a autenticação NTLM não é feita pela Internet. Se o site estiver configurado no IIS para exigir autenticação, essa autenticação falhará. Para corrigir esse problema, você pode especificar o nome do computador remoto em vez do endereço IP.

Outras causas

Se a configuração do IIS não estiver causando o problema, tente estas etapas:

  • Reinicie o Visual Studio com privilégios de Administrador e tente novamente.

    Alguns cenários de depuração de ASP.NET exigem privilégios elevados para o Visual Studio.

  • Se várias instâncias do Visual Studio estiverem em execução, reabra o projeto em uma instância do Visual Studio (com privilégios de Administrador) e tente novamente.

  • Se você estiver usando um arquivo HOSTS com endereços locais, tente usar o endereço de loopback em vez do endereço IP do computador.

    Se você não estiver usando endereços locais, verifique se o arquivo HOSTS inclui a mesma URL de projeto que nas propriedades do projeto, Propriedades > Web > Servidores ou Propriedades > Depuração , dependendo do tipo de projeto.

Mais etapas de solução de problemas

  • Prepare a página localhost no Browser do servidor.

    Se o IIS não estiver instalado corretamente, você deverá receber erros ao digitar http://localhost um navegador.

    Para saber mais sobre como implantar no IIS, confira IIS 8.0 usando ASP.NET 3.5 e ASP.NET 4.5 e, para ASP.NET Core, Host no Windows com IIS.

  • Crie um aplicativo de ASP.NET básico no servidor (ou use um arquivo web.config básico).

    Se você não conseguir que seu aplicativo funcione com o depurador, tente criar um aplicativo de ASP.NET básico localmente no servidor e tente depurar o aplicativo básico. (Talvez você queira usar o modelo padrão ASP.NET MVC.) Se você puder depurar um aplicativo básico, isso poderá ajudá-lo a identificar o que é diferente entre as duas configurações. Procure diferenças nas configurações no arquivo web.config, como regras de reescrita de URL.

Confira também