Solucionar problemas de depuração remota

Aplica-se a: Visual Studio

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

Para solucionar problemas de depuração remota, a primeira etapa é verificar se há 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 instalada

Nos cenários em que você instala manualmente o depurador remoto em um computador remoto, a versão instalada deve corresponder à versão do Visual Studio. Para obter links atuais para baixar o depurador remoto, consulte Depurador Remoto.

Um build de versão está 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 usar um build de depuração ao executar o aplicativo no Visual Studio, mas isso não significa que você tenha instaldo um build de depuração no servidor).

Você consegue anexar ao aplicativo remoto, mas não consegue chegar até os pontos de interrupção (ou os símbolos de depuração não serão carregados)

Para esse problema, talve você veja uma mensagem Nenhum símbolo foi carregado.

Use a janela Módulos para descobrir o status do carregamento dos símbolos do seu 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 do 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, você provavelmente tem 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 o recurso Apenas Meu Código ou implante um build de depuração no servidor.
• Se a configuração Código do 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 o aplicativo foi criado (ou seja, os arquivos .pdb originais ou cópias). Na 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, o msvsmon tem um argumento de linha de comando para habilitar o fallback para arquivos .pdb remotos).

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 que a 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 verificar a versão do aplicativo do ASP.NET, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e escolha Propriedades. Verifique a guia Compilar. A configuração do ASP.NET no servidor é específica para o cenário. Para aplicativos do ASP.NET Framework, talvez seja necessário definir a versão da estrutura no 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 esperado:

• Se o filtro da pesquisa de processo foi definido anteriormente, verifique se você precisa desmarcá-lo.
• Selecione Mostrar processos para todos os usuários para mostrar processos em execução em outras contas de usuário.
• Em conexões lentas, talvez seja interessante desabilitar a Atualização automática.
• Se eles forem alterados dos padrões, os campos Tipo de conexão e Anexar a podem limitar quais processos aparecem na lista.

Você não está se conectando ao processo correto

Se você estiver usando anexar ao processo, certifique-se de anexar 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 do ASP.NET, as portas necessárias são abertas pela instalação do ASP.NET e pelo 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 do 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, confira Executar o depurador remoto como administrador.