Compartilhar via


Solucionar problemas de depuração remota

              Aplica-se a: Visual Studio 2022

Este artigo apresenta etapas de solução de problemas e soluções de alguns problemas comuns com depuração remota.

Para solucionar problemas de depuração remota, a primeira etapa é marcar para mensagens de erro e investigar. A mensagem pode incluir um link com mais informações.

Em seguida, verifique se o aplicativo está sendo executado corretamente no servidor antes de tentar depurá-lo.

Caso contrário, aqui estão os problemas e soluções mais comuns:

Versão incorreta do depurador remoto instalado

Para cenários em que você instala manualmente o depurador remoto em um computador remoto, verifique se a versão instalada corresponde à sua versão do Visual Studio. Para que os links atuais baixem o depurador remoto, consulte Depurador Remoto.

Um build de versão é implantado no servidor em vez de um build de depuração

A ferramenta Publicar e algumas outras opções de publicação têm uma configuração de depuração separada que você precisa definir. (Você pode estar escolhendo um build de depuração ao executar o aplicativo no Visual Studio, mas isso não significa que você instalou um build de depuração no servidor.)

Você pode anexar ao aplicativo remoto, mas não pode atingir pontos de interrupção (ou símbolos de depuração não serão carregados)

Para esse problema, você pode ver uma mensagem Sem símbolos carregados.

Use a janela Módulos para descobrir o status de carregamento de símbolo para o módulo e quais módulos o depurador está tratando como código de usuário ou Meu Código.

  • A coluna Status do Símbolo indica se os símbolos foram carregados corretamente para o módulo.
  • A coluna Código de usuário indica se o módulo que você está tentando depurar é classificado como Meu Código. Se ele estiver sendo exibido incorretamente como Meu Código, provavelmente você terá um build de versão implantado no servidor. Os binários de versão são otimizados e nunca são considerados como Meu Código, portanto, desabilite Just My Code ou implante um build de depuração no servidor.
  • Se a configuração de código de usuário estiver correta, mas os símbolos não forem carregados, verifique se o depurador está usando os arquivos de símbolo corretos. O depurador carrega apenas símbolos (arquivos.pdb) que correspondem exatamente aos arquivos .pdb criados quando um aplicativo foi criado (ou seja, os arquivos ou cópias .pdb originais). Para depuração remota do Windows, por padrão, os arquivos PDB são lidos no computador do Visual Studio e não no servidor. (No entanto, msvsmon tem um argumento de linha de comando para permitir a recolhência para arquivos remotos .pdb.)

Para obter mais informações, consulte Solucionar problemas de pontos de interrupção.

(ASP.NET) A versão do ASP.NET em execução no servidor não é a mesma da versão configurada para seu aplicativo

Talvez seja necessário instalar a versão correta do ASP.NET ou ASP.NET Core no servidor ou no computador local. Para marcar a versão do aplicativo do ASP.NET, clique com o botão direito do mouse no projeto em Gerenciador de Soluções e escolha Propriedades. Verifique a guia Compilar. A configuração de ASP.NET no servidor é específica para o cenário. Para aplicativos ASP.NET Framework, talvez seja necessário definir a versão da estrutura em seu arquivo web.config .

Você não vê o processo necessário na caixa de diálogo Anexar ao Processo

Alguns cenários exigem que você anexe manualmente ao processo correto. Se você estiver usando Anexar ao Processo para seu cenário e não vir o processo que está esperando:

  • Se o filtro do processo de pesquisa foi definido anteriormente, marcar se você precisar limpá-lo.
  • Selecione Mostrar processos para todos os usuários mostrarem processos em execução em outras contas de usuário.
  • Para conexões lentas, talvez você queira desabilitar a atualização automática.
  • Se eles forem alterados de padrões, o tipo De conexão e Anexar aos campos poderão limitar quais processos aparecem na lista.

Você não está anexando ao processo correto

Se você estiver usando a anexação ao processo, certifique-se de estar anexando ao processo correto. Para obter mais informações, consulte Cenários comuns de depuração.

Uma porta necessária não está aberta

Na maioria das configurações ASP.NET, as portas necessárias são abertas pela instalação do ASP.NET e do depurador remoto. No entanto, talvez seja necessário verificar se as portas estão abertas. Por exemplo, em cenários de VM do Azure, você provavelmente precisa abrir a porta de depurador remoto e a porta do servidor (por exemplo, o IIS usa a porta 80).

Privilégios elevados para o depurador remoto podem ser necessários

Em alguns cenários, talvez seja necessário executar o depurador remoto como administrador. Para obter mais informações, consulte Executar o depurador remoto como um administrador.