Устранение неполадок удаленной отладки

Применимо к: Visual Studio

В этой статье описаны действия по устранению неполадок и решения некоторых распространенных проблем с удаленной отладкой.

Чтобы устранить неполадки с удаленной отладкой, сначала необходимо проверка сообщений об ошибках и исследовать их. Сообщение может содержать ссылку с дополнительными сведениями.

Затем убедитесь, что приложение работает правильно на сервере, прежде чем пытаться отладить его.

В противном случае ниже приведены наиболее распространенные проблемы и решения.

Неправильная версия установленного удаленного отладчика

В случаях, когда удаленный отладчик устанавливается вручную на удаленном компьютере, убедитесь, что установленная версия соответствует вашей версии Visual Studio. Текущие ссылки на скачивание удаленного отладчика см. в разделе Удаленный отладчик.

Сборка выпуска развертывается на сервере вместо отладочной сборки.

Средство публикации и некоторые другие параметры публикации имеют отдельный параметр конфигурации отладки, который необходимо задать. (Возможно, вы выбираете отладочную сборку при запуске приложения в Visual Studio, но это не значит, что вы установили отладочную сборку на сервере.)

Вы можете подключиться к удаленному приложению, но не сможете попасть в точки останова (или символы отладки не загружаются).

Для этой проблемы может появилось сообщение Не загружаются символы.

Используйте окно Модули , чтобы узнать состояние загрузки символов для модуля и модули, которые отладчик обрабатывает как пользовательский код или Мой код.

  • Столбец Состояние символа указывает, правильно ли загружены символы для модуля.
  • Столбец Код пользователя указывает, классифицируется ли модуль, который вы пытаетесь отладить, как Мой код. Если он отображается неправильно как "Мой код", вероятно, на сервере развернута сборка выпуска. Двоичные файлы выпусков оптимизированы и никогда не считаются моим кодом, поэтому отключите только мой код или разверните отладочную сборку на сервере.
  • Если параметр Пользовательского кода правильный, но символы не загружаются, убедитесь, что отладчик использует правильные файлы символов. Отладчик загружает только символы (PDB-файлы), которые точно соответствуют PDB-файлам, созданным при сборке приложения (то есть исходным PDB-файлам или копиям). Для удаленной отладки Windows PDB-файлы по умолчанию считываются на компьютере Visual Studio, а не с сервера. (Однако у msvsmon есть аргумент командной строки для включения возврата к удаленным PDB-файлам.)

Дополнительные сведения см. в статье Устранение неполадок с точками останова.

(ASP.NET) Версия ASP.NET, запущенная на сервере, не совпадает с версией, настроенной для приложения.

Возможно, вам потребуется установить правильную версию ASP.NET или ASP.NET Core на сервере или на локальном компьютере. Чтобы проверка версию приложения ASP.NET, щелкните проект правой кнопкой мыши в Обозреватель решений и выберите пункт Свойства. Перейдите на вкладку Сборка. Конфигурация ASP.NET на сервере зависит от сценария. Для приложений ASP.NET Framework может потребоваться задать версию платформы в файлеweb.config .

Необходимый процесс не отображается в диалоговом окне Присоединение к процессу.

В некоторых сценариях требуется вручную подключиться к правильному процессу. Если вы используете подключение к процессу для своего сценария и не видите ожидаемый процесс:

  • Если фильтр процесса поиска был задан ранее, проверка, если нужно очистить его.
  • Выберите Показать процессы для всех пользователей , чтобы отобразить процессы, выполняемые в других учетных записях пользователей.
  • Для медленных подключений может потребоваться отключить автоматическое обновление.
  • Если они были изменены по умолчанию, поля Тип подключения и Присоединить к могут ограничить процессы, отображаемые в списке.

Вы не подключаетесь к правильному процессу

Если вы используете присоединение к процессу, убедитесь, что вы подключаетесь к правильному процессу. Дополнительные сведения см. в разделе Общие сценарии отладки.

Не открыт необходимый порт

В большинстве ASP.NET установок необходимые порты открываются установкой ASP.NET и удаленным отладчиком. Однако может потребоваться убедиться, что порты открыты. Например, в сценариях виртуальных машин Azure, вероятно, потребуется открыть порт удаленного отладчика и порт сервера (например, IIS использует порт 80).

Для удаленного отладчика могут потребоваться повышенные привилегии

В некоторых сценариях может потребоваться запустить удаленный отладчик от имени администратора. Дополнительные сведения см. в статье Запуск удаленного отладчика от имени администратора.