您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info
問題
使用開發人員入口網站的 SmartDocs 發出即時 API 要求時發生錯誤。
錯誤訊息
開發人員入口網站上常見的錯誤是「發生內部錯誤。 請重試要求」。
可能原因
如果開發人員入口網站無法從後端 (smartdocs Proxy 或實際端點) 取得回應，就可能發生這個錯誤。
診斷
在瀏覽器中啟用「開發人員工具」，並檢查「網路」分頁，找出實際錯誤。
下表列出常見錯誤和典型原因：
|
錯誤 |
常見原因 |
|
ERR_NAME_NOT_RESOLVED |
|
|
複合型內容 |
|
|
500 - 內部伺服器錯誤 |
接下來，我們將逐一說明這些原因，以及解決問題的步驟。
SmartDocs Proxy 設定錯誤或網路防火牆限制
「ERR_NAME_NOT_RESOLVED」ERR_NAME_NOT_RESOLVED訊息表示智慧文件 Proxy 網址設定有誤，或是由於防火牆限制，入口網站存取的網路無法呼叫智慧文件 Proxy 網址。智慧文件 Proxy 必須可從網際網路或內部網路 (適用於內部 API) 存取。
解析度
將 smartdocs Proxy 部署至 Edge 上的虛擬主機，並使用可從網際網路存取的主機名稱，確保所有必要網路都能存取 smartdocs Proxy。
入口網站透過 HTTPS 設定，SmartDocs 要求透過 HTTP 設定
「複合型內容」錯誤表示從透過 HTTPS 載入的網頁，透過 HTTP 呼叫 smartdocs Proxy。
解析度
透過 HTTPS 公開 smartdocs Proxy，即可解決問題。如要這麼做，請部署 smartdocs Proxy，加入設定為使用 TLS/SSL 的虛擬主機 (通常是「安全」虛擬主機)。
SmartDocs Proxy 傳回例外狀況
「500 - Internal Server Error」訊息可能是「smartdocs」Proxy 發生問題所致。在這種情況下，您會發現智慧文件 Proxy 傳回這項錯誤。
診斷
如要診斷「smartdocs」Proxy 的錯誤，請使用「追蹤」工具，詳情請見下文。詳情請參閱「使用 Trace 工具」。
- 在「VALIDATE」機構中為「smartdocs」Proxy 啟用追蹤功能，找出傳回 500 Internal Server Error 的特定政策。
- 在追蹤記錄中選取特定政策，找出錯誤原因。
解析度
修正系統發現的錯誤。如需協助，請與 Apigee Edge 支援團隊聯絡。
Edge Message Processors 無法呼叫已發布的 API 端點
如果代管 Smartdocs Proxy 的機構所屬訊息處理器無法呼叫 API 端點，也可能發生 500 - Internal Server Error。
診斷
如要診斷「smartdocs」Proxy 的錯誤，請使用「追蹤」工具，詳情請見下文。詳情請參閱「使用 Trace 工具」。
- 在「VALIDATE」機構中，為「smartdocs」Proxy 啟用「trace」，找出傳回 500 Internal Server Error 的特定政策。
- 如上所示的 UI 追蹤記錄範例，JavaScript 政策「BuildTargetAPIRequest」無法執行目標網址。
- 從 JavaScript 政策「BuildTargetAPIRequest」取得目標網址。
- 直接從與「VALIDATE」機構相關聯的訊息處理器節點呼叫網址，如下所示：
curl -v <target URL>
- 修正所有觀察到的錯誤。
解析度
- 確認開發人員入口網站上發布的 API 可從與「VALIDATE」機構相關聯的訊息處理器叫用，並修正遇到的任何錯誤。
- 如果可以從訊息處理器直接執行 API 呼叫，您應該也能透過 SmartDocs 執行 API。
- 透過 SmartDocs 執行 API 呼叫，並檢查問題是否已修正。