risoluzione dei problemi di Introduzione con WSDAPI

  • Articolo

Questa guida alla risoluzione dei problemi contiene un set di procedure di diagnostica che possono essere usate per identificare la causa dei problemi dell'applicazione. Dopo aver identificato correttamente la causa del problema, è possibile applicare le soluzioni suggerite nella procedura di diagnostica per risolvere il problema.

Esistono due modi per determinare la procedura di diagnostica da usare. Un modo consiste nel passare alla pagina di risoluzione dei problemi per il tipo di client per visualizzare un elenco dettagliato delle procedure di diagnostica da usare per risolvere i problemi del client. L'altro modo consiste nel passare al riferimento rapido alla risoluzione dei problemi riportato di seguito per visualizzare le tabelle di riepilogo che mostrano problemi comuni con le applicazioni WSDAPI e le procedure da usare per diagnosticare i problemi.

Risoluzione dei problemi per tipo di client

Negli argomenti seguenti vengono illustrate le procedure di diagnostica pertinenti per tipo di client. Questi argomenti illustrano anche i modelli di messaggio associati al tipo di client.

Guida di riferimento rapido per la risoluzione dei problemi

Le tabelle seguenti illustrano alcuni problemi che possono impedire ai client e agli host WSDAPI di vedersi reciprocamente nella rete e di scambiare metadati del dispositivo. Le tabelle mostrano anche le procedure di diagnostica da eseguire e i criteri da usare per valutare se l'applicazione soffre di un problema specifico.

Problemi relativi all'ambiente di rete

Problema Procedura di diagnostica Identificazione dei problemi
Il firewall blocca il traffico di individuazione di rete. Controllo delle impostazioni dell'adapter e del firewall L'abilitazione dell'eccezione individuazione di rete nel firewall risolve il problema.
Le eccezioni del firewall specifiche dell'applicazione bloccano i messaggi. Controllo delle impostazioni dell'adapter e del firewall La disabilitazione del firewall risolve il problema. WF.msc mostra le regole del firewall specifiche dell'applicazione.
Il dispositivo non risponde alle richieste UDP inviando un messaggio ProbeMatches o ResolveMatches in modo tempestivo (meno di 4 secondi). Controllo delle impostazioni dell'adapter e del firewall La disabilitazione del firewall risolve il problema e un host generico che risponde in meno di 4 secondi funziona correttamente.
Il contesto di sicurezza dell'applicazione non è corretto, ovvero il client e l'host non dispongono di autorizzazioni adeguate nella rete. Uso di un host generico e di un client per l'individuazione WS-UDP o l'uso di un host generico e un client per Exchange di metadati HTTP L'indirizzo del dispositivo non viene visualizzato nell'output del client di debug WSD. L'esecuzione dell'applicazione come amministratore risolve il problema.
Un criterio IPSec blocca i messaggi. Uso di un host generico e di un client per l'individuazione WS-UDP o l'uso di un host generico e un client per Exchange di metadati HTTP L'indirizzo del dispositivo non viene visualizzato nell'output del client di debug WSD. Il problema non viene risolto disabilitando il firewall. Il problema non può essere riprodotto in un computer non soggetto a criteri IPSec.

Problemi di individuazione del traffico

Problema Procedura di diagnostica Identificazione del problema
I messaggi Hello, Probe o Resolve non vengono trasmessi in rete perché l'applicazione non enumera correttamente le interfacce di rete multicast. Uso del client di debug WSD per verificare il traffico multicast I messaggi Hello, Probe o Resolve non vengono visualizzati nell'output del client di debug WSD. I pacchetti non vengono visualizzati nella rete. I pacchetti non vengono generati per l'interfaccia di loopback o per altre interfacce.
I messaggi probe non vengono inviati dal multicast UDP alla porta 3702 (per le applicazioni che non usano l'individuazione diretta). Analisi delle tracce di rete per l'individuazione WS-UDP L'ispezione del messaggio indica che è stato inviato alla porta sbagliata.
Il messaggio Probe non contiene un elemento Types o l'elemento Types è vuoto. Analisi delle tracce di rete per l'individuazione WS-UDP o l'analisi delle tracce di rete per le applicazioni tramite l'individuazione diretta L'ispezione del messaggio indica che l'elemento Types non è presente o vuoto.
L'elemento Types di un messaggio Probe non contiene i tipi a cui risponderà un host. Analisi delle tracce di rete per l'individuazione WS-UDP o l'analisi delle tracce di rete per le applicazioni tramite l'individuazione diretta L'ispezione del messaggio mostra che l'elemento Types contiene un valore non valido o non corretto.
Un messaggio ProbeMatches non è stato inviato unicast alla porta UDP da cui è stato inviato il probe . Analisi delle tracce di rete per l'individuazione WS-UDP o l'analisi delle tracce di rete per le applicazioni tramite l'individuazione diretta L'ispezione dell'output mostra che non è stato inviato alcun messaggio ProbeMatches o che il messaggio è stato inviato alla porta errata. Nota: Per le applicazioni che usano l'individuazione diretta, probeMatches deve essere inviato tramite HTTP o HTTPS in risposta al messaggio probe .
Il messaggio ProbeMatches non contiene un elemento RelatesTo o l'elemento RelatesTo è vuoto. Analisi delle tracce di rete per l'individuazione WS-UDP o l'analisi delle tracce di rete per le applicazioni tramite l'individuazione diretta L'ispezione del messaggio mostra che l'elemento RelatesTo non è presente o vuoto.
Il valore dell'elemento RelatesTo in un messaggio ProbeMatches non corrisponde al valore dell'elemento MessageId del messaggio Probe corrispondente. Analisi delle tracce di rete per l'individuazione WS-UDP o l'analisi delle tracce di rete per le applicazioni tramite l'individuazione diretta L'ispezione del messaggio mostra che l'elemento RelatesTo contiene un valore non valido o non corretto.
L'elemento XAddrs incluso in un messaggio ProbeMatches non è conforme alle regole di convalida XAddr. Analisi delle tracce di rete per l'individuazione WS-UDP o l'analisi delle tracce di rete per le applicazioni tramite l'individuazione diretta L'ispezione del messaggio indica che XAddrs non è valido.
I messaggi di risoluzione non vengono inviati dal multicast UDP alla porta 3702 (per le applicazioni che non usano l'individuazione diretta). Analisi delle tracce di rete per l'individuazione WS-UDP o l'analisi delle tracce di rete per le applicazioni tramite l'individuazione diretta L'ispezione dell'output mostra che il messaggio Resolve è stato inviato alla porta errata.
Un messaggio ResolveMatches non è stato inviato unicast alla porta UDP da cui è stato inviato un messaggio resolve . Analisi delle tracce di rete per l'individuazione WS-UDP o l'analisi delle tracce di rete per le applicazioni tramite l'individuazione diretta L'ispezione dell'output indica che non è stato inviato alcun messaggio ResolveMatches o che il messaggio è stato inviato alla porta errata.

Problemi di scambio dei metadati

Problema Procedura di diagnostica Identificazione del problema
L'indirizzo di trasporto annunciato dall'host non è corretto. Uso di un host generico e di un client per Exchange di metadati HTTP L'ispezione degli XAddrs nell'output del client di debug WSD indica che l'indirizzo di trasporto non è corretto o non è valido.
Impossibile stabilire una connessione TCP per lo scambio di metadati. Analisi delle tracce di rete per lo scambio di metadati HTTP L'output dell'analizzatore pacchetti non mostra lo scambio di pacchetti seguente:
  • Un pacchetto TCP SYN inviato dal client
  • Un pacchetto TCP SYN/ACK inviato dall'host
  • Un pacchetto TCP ACK inviato dal client
Il client non ha inviato una richiesta HTTP GET valida. Analisi delle tracce di rete per lo scambio di metadati HTTP Non è presente alcuna richiesta HTTP GET nell'output dell'analizzatore pacchetti o la richiesta non è valida.
Il client non ha inviato un messaggio di WS-Transfer Get valido. Analisi delle tracce di rete per lo scambio di metadati HTTP Nell'output dell'analizzatore pacchetti non è presente alcun WS-Transfer o il messaggio è in formato non valido.
L'host non è in ascolto sul percorso URL specificato nella richiesta HTTP GET. Controllo delle tracce di rete per Exchange dei metadati HTTP Non esiste alcuna risposta HTTP nell'output dell'analizzatore pacchetti.
Il messaggio WS-Transfer Get non contiene un elemento To o l'elemento To è vuoto. Controllo delle tracce di rete per Exchange dei metadati HTTP L'ispezione del messaggio mostra che l'elemento To non è presente o vuoto.
Il valore dell'elemento To di un messaggio WS-Transfer Get non corrisponde a uno degli indirizzi endpoint dell'host. Controllo delle tracce di rete per Exchange dei metadati HTTP L'ispezione del messaggio mostra che il valore dell'elemento To non corrisponde a uno degli indirizzi dell'endpoint annunciati nel messaggio ProbeMatches o ResolveMatches dell'host.
L'host non ha inviato un'intestazione di risposta HTTP valida. Controllo delle tracce di rete per Exchange dei metadati HTTP Non è presente alcuna risposta HTTP nell'output dell'analizzatore pacchetti o la richiesta è non valida.
L'intestazione di risposta HTTP inviata dall'host indica che la richiesta non può essere completata. Controllo delle tracce di rete per Exchange dei metadati HTTP L'intestazione di risposta ha un codice di stato diverso da HTTP/1.1 200.
L'host non ha inviato un messaggio GetResponse valido. Controllo delle tracce di rete per Exchange dei metadati HTTP Non è presente alcun messaggio GetResponse nell'output dell'analizzatore pacchetti o il messaggio è non valido.
Il messaggio GetResponse non contiene un elemento RelatesTo oppure l'elemento RelatesTo è vuoto. Controllo delle tracce di rete per Exchange dei metadati HTTP L'ispezione del messaggio mostra che l'elemento RelatesTo non è presente o vuoto.
Il valore dell'elemento RelatesTo in un messaggio GetResponse non corrisponde al valore dell'elemento MessageId dal messaggio Get corrispondente. Controllo delle tracce di rete per Exchange dei metadati HTTP L'ispezione del messaggio mostra che l'elemento RelatesTo contiene un valore non corretto o non valido.

Guida alla risoluzione dei problemi di WSDAPI