查看 Apigee Edge 說明文件。
前往
Apigee X說明文件。 資訊
問題
使用開發人員的 SmartDoc 提出即時 API 要求時發生錯誤 入口網站。
錯誤訊息
開發人員入口網站中常見的錯誤為「發生內部錯誤， 請再試一次。」
可能原因
當開發人員入口網站無法從後端取得回應 (智慧文件) 時，就可能發生這個錯誤 Proxy 或實際端點)。
診斷
在瀏覽器中啟用「開發人員工具」，然後查看「網路」分頁： 找出實際錯誤。
下表列出常見錯誤及常見原因：
|
錯誤 |
常見原因 |
|
ERR_NAME_NOT_RESOLVED |
|
|
複合型內容 |
|
|
500 - 內部伺服器錯誤 |
以下將逐一說明各個原因，並說明如何解決問題。
SmartDoc Proxy 設定錯誤或網路防火牆 限制
「ERR_NAME_NOT_RESOLVED」訊息表示 Smartdocs Proxy 網址設定錯誤，或是存取入口網站的網路是 因為防火牆限制，所以無法呼叫 Smartdocs Proxy 網址。Smartdocs Proxy 必須可透過網際網路或內部網路 (針對內部 API) 存取。
解析度
部署應用程式，確保可以透過所有必要網路存取 Smartdocs Proxy Smartdocs Proxy 可連線到 Edge 上的虛擬主機 (主機名稱如下) 以及存取網際網路
透過 HTTPS 設定的入口網站、透過 HTTP 發出的 SmartDoc 要求
出現「混合內容」錯誤表示 Smartdocs Proxy 也就是透過 HTTPS 載入的網頁。
解析度
將 Smartdocs Proxy 顯示在 https 上，以解決問題。做法是部署 Smartdocs Proxy，納入設為使用 TLS/SSL 的虛擬主機 (通常是「安全」的虛擬主機)。
SmartDoc Proxy 傳回例外狀況
500 - Internal Server Error 訊息的可能原因為 「smartdocs」 Proxy在這個例子中，您會發現 Smartdocs Proxy 傳回 錯誤。
診斷
使用追蹤工具，透過「smartdocs」 Proxy 診斷錯誤 。詳情請參閱使用追蹤工具。
- 在以下位置啟用「smartdocs」 Proxy 的追蹤記錄 「VALIDATE」機構可以找出 傳回 500 內部伺服器錯誤。
- 在追蹤記錄中選取特定政策，找出錯誤原因。
解析度
修正發現的錯誤。如需協助，請與 Apigee Edge 支援團隊聯絡。
Edge 訊息處理器無法呼叫已發布的 API 端點
500 - 當「訊息處理者」下的 代管 Smartdocs Proxy 的機構無法呼叫 API 端點。
診斷
使用追蹤工具，透過「smartdocs」 Proxy 診斷錯誤 。詳情請參閱使用追蹤工具。
- 啟用「smartdocs」的追蹤記錄 註冊「VALIDATE」機構中的 Proxy，即可找到特定政策 傳回 500 內部伺服器錯誤。
- 在上述的 UI 追蹤記錄範例中，我們發現 JavaScript 政策 「BuildTargetAPIRequest」無法執行目標網址。
- 透過 JavaScript 政策取得目標網址 「BuildTargetAPIRequest」。
- 從與以下內容相關聯的訊息處理器節點直接呼叫網址
「VALIDATE」機構，如下所示：
curl -v <target URL>
- 修正任何觀察到的錯誤。
解析度
- 確保訊息處理者可叫用在開發人員入口網站上發布的 API 與「VALIDATE」機構建立關聯，並修正所有錯誤 。
- 如果您可以直接從訊息處理器執行 API 呼叫， 應該也能透過 SmartDoc 執行 API。
- 透過 SmartDoc 執行 API 呼叫，並確認問題是否已解決。