6.1 驅動程式 Shim 錯誤

下表識別可能發生於核心驅動程式 Shim 的錯誤。 含有數字代碼的錯誤訊息視應用程式或 Web 服務的不同,可以包含多條訊息。

錯誤訊息

層級

描述

307 暫時重新導向

重試

「訂閱者」通道嘗試將資料傳送至應用程式或 Web 服務,但是卻收到「307 暫時重新導向」的回應。

「訂閱者」將等待一段時間 (通常是 30秒),然後再重試。

408 申請逾時

重試

「訂閱者」通道嘗試將資料傳送至應用程式或 Web 服務,但是卻收到「408 申請逾時」回應。

「訂閱者」將等待一段時間 (通常是 30秒),然後再重試。

503 服務無法使用

重試

「訂閱者」通道嘗試將資料傳送至應用程式或 Web 服務,但是卻收到「503 服務無法使用」回應。

「訂閱者」將等待一段時間 (通常是 30秒),然後再重試。

504 閘道逾時

重試

「訂閱者」通道嘗試將資料傳送至應用程式或 Web 服務,但是卻收到「504閘道逾時」回應。

「訂閱者」將等待一段時間 (通常是 30秒),然後再重試。

上表尚有幾種數字錯誤碼未列出。

錯誤

HTTP 伺服器 (「訂閱者」通道可能會與之通訊的那些伺服器) 會傳回數字值及一條簡短的描述性訊息,用以指出申請的狀態。

200-299 範圍內的數字表示成功,因此不會產生錯誤訊息。

上面所列的數字 (307、408、503 及 504) 表示暫時狀況,因此會重試申請。

其他數字錯誤碼會產生錯誤訊息,這條錯誤訊息會包含該代碼及 HTTP 伺服器所提供的訊息。 在大部分情況下,驅動程式會繼續執行,而導致錯誤的指令則不會重試。

與 HTTP 伺服器通訊發生問題。 確定伺服器在執行中且正在接受申請。

重試

在通訊或嘗試與 HTTP 伺服器通訊的過程中,「訂閱者」通道收到一個 IOException。

您收到此錯誤,可能是因為伺服器不執行、發生多載、因防火牆或其他限制而無法進行存取,或「訂閱者」組態中提供的 URL 不正確。

導致此錯誤的指令會在稍後重試。

在預設狀態下,HTTP/SOAP 驅動程式不會傳回任何應用程式綱要。

如果您想讓 Shim 報告某個應用程式特定綱要,則可以撰寫自己的 Java 類別來實作 SchemaReporter 介面,然後再設定驅動程式將此類別做為 Java 延伸功能載入。

警告

Metadirectory 引擎會呼叫驅動程式的 DriverShim.getSchema() 方法,但是驅動程式尚未使用 SchemaReporter 自訂進行延伸。

驅動程式會繼續執行。

已呼叫 Subscriber.execute(),但是未正確設定「訂閱者」。 已忽略指令。

您應該設定「訂閱者」或清除「訂閱者」的過濾器,這樣就不會收到指令。

警告

未正確啟始化驅動程式的「訂閱者」通道。 最有可能的原因是驅動程式組態格式不正確。

驅動程式會繼續執行,但是每當「訂閱者」通道收到事件時都會顯示此訊息。

pubHostPort 必須使用 host:port 格式

嚴重錯誤

「發行者」通道組態造成的錯誤。

檢視「發行者」通道參數,以確認提供的主機及連接埠號碼都有效。

MalformedURLException

嚴重錯誤

「訂閱者」通道參數中提供的 URL 不是有效的 URL 格式。

多個例外

嚴重錯誤

無法正確啟始化 HTTP 監聽程式時,此訊息會出現在追蹤中。 導致此狀況發生的原因有許多。 請檢查您的「發行者」設定,以確定所指定的連接埠未被使用且其他「發行者」設定正確。

HTTPS 主機名稱錯誤: 應該. . .

重試

「訂閱者」通道上無法進行 SSL 信號交換時,會出現此訊息。 這表示伺服器證書所提供的接收者與 HTTPS URL 中指定的 IP 位址或主機名稱不符。

請在 URL 中使用 DNS 主機名稱,而不要使用 IP 位址。