Поделиться через

начало работы с устранением неполадок WSDAPI

  • Статья

Это руководство по устранению неполадок содержит набор диагностических процедур , которые можно использовать для выявления причин проблем с приложением. После успешного определения причины проблемы можно применить предлагаемые решения в процедуре диагностики, чтобы устранить проблему.

Существует два способа определить используемую процедуру диагностики. Один из способов — перейти на страницу устранения неполадок для типа клиента, чтобы просмотреть пошаговый список диагностических процедур, используемых для устранения неполадок клиента. Другой способ — перейти к краткому справочнику по устранению неполадок ниже, чтобы просмотреть сводные таблицы, показывающие распространенные проблемы с приложениями WSDAPI и процедуры, используемые для диагностики проблем.

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

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

Краткий справочник по устранению неполадок

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

Проблемы с сетевой средой

Проблема Процедура диагностики Идентификация проблемы
Брандмауэр блокирует трафик обнаружения сети. Проверка параметров адаптера и брандмауэра Включение исключения сетевого обнаружения в брандмауэре решает проблему.
Исключения брандмауэра, относящиеся к приложению, блокируют сообщения. Проверка параметров адаптера и брандмауэра Отключение брандмауэра решает проблему. В WF.msc отображаются правила брандмауэра для конкретных приложений.
Устройство не отвечает на запросы UDP, отправляя сообщение ProbeMatches или ResolveMatches своевременно (менее 4 секунд). Проверка параметров адаптера и брандмауэра Отключение брандмауэра решает проблему, и универсальный узел, который отвечает менее чем за 4 секунды, работает успешно.
Контекст безопасности приложения неверен (то есть клиент и узел не имеют достаточных разрешений в сети). Использование универсального узла и клиента для UDP WS-Discovery или использование универсального узла и клиента для обмена метаданными HTTP Адрес устройства не отображается в выходных данных клиента отладки WSD. Запуск приложения от имени администратора решает проблему.
Политика IPSec блокирует сообщения. Использование универсального узла и клиента для UDP WS-Discovery или использование универсального узла и клиента для обмена метаданными HTTP Адрес устройства не отображается в выходных данных клиента отладки WSD. Проблема не решается путем отключения брандмауэра. Проблема не может быть воспроизведена на компьютере, на котором не распространяются политики IPSec.

Обнаружение проблем с трафиком

Проблема Процедура диагностики Идентификация проблемы
Сообщения Hello, Probe или Resolve не передаются по сети, так как приложение неправильно перечисляет сетевые интерфейсы многоадресной рассылки. Использование клиента отладки WSD для проверки трафика многоадресной рассылки Сообщения Hello, Probe или Resolve не отображаются в выходных данных клиента отладки WSD. Пакеты не отображаются в сети. Пакеты не создаются для интерфейса замыкания на себя или для других интерфейсов.
Сообщения пробы не отправляются многоадресной рассылкой UDP на порт 3702 (для приложений, не использующих направленное обнаружение). Проверка трассировок сети для обнаружения WS-UDP Проверка сообщения показывает, что оно было отправлено на неправильный порт.
Сообщение пробы не содержит элемент Types или элемент Types пуст. Проверка трассировок сети для обнаружения UDP WS или проверка трассировок сети для приложений с помощью направленного обнаружения Проверка сообщения показывает, что элемент Types отсутствует или пуст.
Элемент Types сообщения пробы не содержит типы, на которые будет отвечать узел. Проверка трассировок сети для обнаружения UDP WS или проверка трассировок сети для приложений с помощью направленного обнаружения Проверка сообщения показывает, что элемент Types содержит неправильное или неправильное значение.
Сообщение ProbeMatches не было отправлено одноадресной рассылки на порт UDP, с которого была отправлена проба . Проверка трассировок сети для обнаружения UDP WS или проверка трассировок сети для приложений с помощью направленного обнаружения Проверка выходных данных показывает, что сообщение ProbeMatches не было отправлено или сообщение было отправлено на неправильный порт. Примечание: Для приложений, использующих направленное обнаружение, ProbeMatches должны отправляться по протоколу HTTP или HTTPS в ответ на сообщение пробы .
Сообщение ProbeMatches не содержит элемент RelatesTo или элемент RelatesTo пуст. Проверка трассировок сети для обнаружения UDP WS или проверка трассировок сети для приложений с помощью направленного обнаружения Проверка сообщения показывает, что элемент RelatesTo отсутствует или пуст.
Значение элемента RelatesTo в сообщении ProbeMatches не соответствует значению элемента MessageId из соответствующего сообщения probe . Проверка трассировок сети для обнаружения UDP WS или проверка трассировок сети для приложений с помощью направленного обнаружения Проверка сообщения показывает, что элемент RelatesTo содержит неправильное или неправильное значение.
Элемент XAddrs , включенный в сообщение ProbeMatches , не соответствует правилам проверки XAddr. Проверка трассировок сети для обнаружения UDP WS или проверка трассировок сети для приложений с помощью направленного обнаружения Проверка сообщения показывает, что XAddrs являются недопустимыми.
Сообщения разрешения не отправляются многоадресной рассылкой UDP на порт 3702 (для приложений, не использующих направленное обнаружение). Проверка трассировок сети для обнаружения UDP WS или проверка трассировок сети для приложений с помощью направленного обнаружения Проверка выходных данных показывает, что сообщение Resolve было отправлено на неправильный порт.
Сообщение ResolveMatches не было отправлено одноадресной рассылки на порт UDP, с которого было отправлено сообщение Resolve . Проверка трассировок сети для обнаружения UDP WS или проверка трассировок сети для приложений с помощью направленного обнаружения Проверка выходных данных показывает, что сообщение ResolveMatches не было отправлено или сообщение было отправлено на неправильный порт.

Проблемы с обменом метаданными

Проблема Процедура диагностики Идентификация проблемы
Неправильный адрес транспорта, объявленный узлом. Использование универсального узла и клиента для обмена метаданными HTTP Проверка XAddrs в выходных данных клиента отладки WSD показывает, что адрес транспорта неправильный или неправильный.
Не удалось установить TCP-подключение для обмена метаданными. Проверка трассировок сети для обмена метаданными HTTP В выходных данных анализатора пакетов не отображается следующий обмен пакетами:
  • Пакет TCP SYN, отправленный клиентом
  • Пакет TCP SYN/ACK, отправленный с узла.
  • Пакет TCP ACK, отправленный клиентом
Клиент не отправил допустимый HTTP-запрос GET. Проверка трассировок сети для обмена метаданными HTTP В выходных данных анализатора пакетов отсутствует HTTP-запрос GET, или запрос имеет неправильный формат.
Клиент не отправил допустимое сообщение WS-Transfer Get . Проверка трассировок сети для обмена метаданными HTTP В выходных данных анализатора пакетов нет WS-Transfer получить сообщение или сообщение имеет неправильный формат.
Узел не прослушивает URL-путь, указанный в HTTP-запросе GET. Проверка трассировок сети для обмена метаданными HTTP В выходных данных анализатора пакетов отсутствует HTTP-ответ.
Сообщение WS-Transfer Get не содержит элемент To или элемент To пуст. Проверка трассировок сети для обмена метаданными HTTP Проверка сообщения показывает, что элемент To отсутствует или пуст.
Значение элемента To сообщения WS-Transfer Get не соответствует одному из адресов конечной точки узла. Проверка трассировок сети для обмена метаданными HTTP Проверка сообщения показывает, что значение элемента To не соответствует одному из адресов конечной точки, объявленных в сообщении ProbeMatches или ResolveMatches узла.
Узел не отправил допустимый заголовок HTTP-ответа. Проверка трассировок сети для обмена метаданными HTTP В выходных данных анализатора пакетов отсутствует HTTP-ответ, или запрос имеет неправильный формат.
Заголовок HTTP-ответа, отправленный узлом, указывает, что запрос не может быть выполнен. Проверка трассировок сети для обмена метаданными HTTP Заголовок ответа имеет код состояния, отличный от HTTP/1.1 200.
Узел не отправил допустимое сообщение GetResponse . Проверка трассировок сети для обмена метаданными HTTP В выходных данных анализатора пакетов отсутствует сообщение GetResponse или сообщение имеет неправильный формат.
Сообщение GetResponse не содержит элемент RelatesTo или элемент RelatesTo пуст. Проверка трассировок сети для обмена метаданными HTTP Проверка сообщения показывает, что элемент RelatesTo отсутствует или пуст.
Значение элемента RelatesTo в сообщении GetResponse не соответствует значению элемента MessageId из соответствующего сообщения Get . Проверка трассировок сети для обмена метаданными HTTP Проверка сообщения показывает, что элемент RelatesTo содержит неправильное или неправильное значение.

Руководство по устранению неполадок WSDAPI