Web 傳訊服務疑難排解

下一節包含使用 Web 傳訊服務時的疑難排解資訊。


執行時期啟用參照

您必須先安裝及啟用 Web 傳訊服務執行時期,才能安裝啟用 Web 傳訊的應用程式。 如果未安裝及啟用執行時期,就安裝啟用 Web 傳訊的應用程式,當您試圖存取 Web 傳訊 URI 時,會出現下列錯誤訊息以及 503 Servlet 錯誤:

    CWPSB1701E: 未配置下列送入 URI: /uri 的 Web 傳訊服務

當出現這個訊息時,您應該先驗證是否已安裝及啟用 Web 傳訊服務。 請參閱啟用 Web 傳訊服務,以取得詳細資料。 Web 傳訊服務安裝及啟用成功,伺服器啟動時,會出現下列日誌訊息:

     CWPSB1102I: 已啟動 Web 傳訊服務。

如果已安裝及啟用 Web 傳訊服務,仍出現配置錯誤,請驗證下列各項:

用戶端錯誤訊息參照

Web 傳訊服務使用 Bayeux 通訊協定。 大部分 Bayeux 通訊協定訊息欄位都會有一個順利完成的 Boolean 欄位及一個相關聯的錯誤欄位。 如果 Bayeux 作業不成功,Web 傳訊服務會嘗試傳送錯誤資訊,來協助應用程式開發者和一般使用者判斷作業失敗原因。 Bayeux 錯誤字串格式包含 3 個用冒號區隔的引數。 第一個引數是錯誤碼,以便進行比較。 第二個引數是失敗所涉及的引數清單,以逗點來區隔。 最後一個引數是錯誤訊息的簡要說明。 範例錯誤訊息如下:

下表列出作業失敗時,Web 傳訊服務傳給 Bayeux 用戶端的大部分錯誤訊息。 當進行用戶端失敗除錯時,請參閱這份表格。 在許多情況下,當發生這些用戶端錯誤時,請檢查伺服器日誌,以取得其他資訊。

錯誤碼 簡短的說明 引數 說明
300 版本號碼不符 傳給伺服器的最低及最高版本。 伺服器找不到符合用戶端所提供的版本及最低版本欄位的版本。 在大部分情況下,伺服器都會要求用戶端在 version 和 minimumVersion 欄位中,以伺服器所提供的版本號碼來重新交換信號。
301 連線類型不符 用戶端提供的連線類型。 用戶端試圖利用伺服器不支援的連線類型來交換信號或進行連線。 信號交換回應會包含一份支援的連線類型清單。 如果在信號交換要求期間收到這個錯誤訊息,用戶端應該會嘗試用支援的連線類型清單中的有效值來重新連線。 如果在連接要求的回應中提供了這個錯誤,伺服器會引導用戶端重新交換信號,並同意使用共用連線類型。
302 延伸不符 提供的延伸功能。 Bayeux 通訊協定提供一個延伸機制,以便啟用超出 Bayeux 通訊協定所支援的功能。 在某些情況下,可能會提供無效的延伸功能。 在這個版本中,伺服器會忽略任何無法辨識的延伸功能。
400 伺服器無法辨識要求。 用戶端傳送一個伺服器無法辨識的要求。 這個錯誤訊息的可能原因如下:
  • 用戶端傳送含有無效 JSON 的要求。
  • 在表單編碼公佈要求中,未將 JSON 要求當作訊息欄位來傳送。
401 指定的用戶端 ID 不明。 指定的用戶端 ID。 當伺服器無法辨識用戶端 ID 時,就會提供這個訊息。 在大部分情況下,提供這個錯誤訊息,還會附加 Bayeux 建議機制來通知用戶端重新交換信號,重新訂閱先前所訂閱的主題。 這個錯誤最常出現於下列時機:
  • 用戶端盲目嘗試以無效的用戶端 ID 來進行連線。
  • 在叢集環境中,有伺服器或階段作業親緣性失敗。
  • 用戶端試圖連線,但超出 Bayeux 階段作業逾時值。
402 要求遺漏必要的參數。 遺漏參數。 Bayeux 通訊協定為許多 Bayeux 訊息規定了若干必要欄位。 如果遺漏了某個必要欄位,就會擲出錯誤訊息來指出遺漏的欄位。
403 禁止指定的通道。 禁止的通道。 如果用戶端試圖向通道訂閱或發佈,但沒有適當的授權許可,就會向用戶端傳回這個錯誤。
404 指定的通道不明。 不明通道。 用戶端試圖向不明的通道訂閱、取消訂閱或發佈。 當指定了 multipleDestination 通道格式,但第一個引數不符合現有服務整合匯流排主題空間或主題空間別名時,最常擲出這個錯誤。
405 指定的通道語法無效。 無效的通道格式。 當指定無效的通道格式時,會發出這個訊息。 請參閱 Bayeux 通訊協定,以取得有效 Bayeux 通道格式的相關資訊。
406 指定的延伸欄位無效。 無效的延伸欄位。 當提供無效的延伸欄位時,會發出這個訊息。 Web 傳訊服務實作會忽略所提供而它無法辨識的延伸欄位,因此,用戶端不應見到這個錯誤訊息。
407 發佈要求失敗。 發出發佈要求的通道。 這個錯誤訊息指出發佈要求失敗。在大部分情況下,這表示 clientCanPublish 選項已設為 false。
408 用戶端無權連接以接收或發佈訊息。 在信號交換或連接要求期間,發出了這個錯誤訊息。 在大部分情況下,這個錯誤訊息表示配置服務整合匯流排安全時,尤其是授予這個送入使用者的匯流排連接器角色時,發生問題,
500 伺服器發現內 部錯誤,無法完成要求。 發現內部伺服器錯誤。請檢查伺服器日誌,以取得相關資訊。
503 服務無法使用。 與服務整合匯流排通訊時,發生錯誤。 這通常發生在與傳訊引擎通訊失敗之時,例如傳訊引擎已停止。 請檢查伺服器日誌,以取得相關資訊。


使用條款 | 意見