

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對 Amazon Neptune 筆記本問題進行故障診斷
<a name="graph-notebook-troubleshooting"></a>

在 JupyterLab 中使用 Neptune 筆記本時，您可能會偶爾遇到與瀏覽器行為、JupyterLab 本身或 Amazon SageMaker AI 整合相關的問題。下列各節說明最常見的問題以及如何解決這些問題。

## Widget 狀態去同步
<a name="graph-notebook-troubleshooting-widget-state"></a>

圖形筆記本小工具有時可能會在 JupyterLab UI 和核心後端之間取消同步。發生這種情況時，您可能會看到小工具顯示錯誤或錯誤訊息，如下所示：

```
Model class 'OutputModel' from module '@jupyter-widgets/output' is loaded but cannot be instantiated
```

這通常發生在長時間閒置之後、在筆記本索引標籤之間切換、清除瀏覽器快取之後、網路連線不穩定期間，或重新開啟具有未儲存小工具輸出的筆記本時。

若要解決此問題，請從**核心功能表中選擇重新啟動核心並清除所有輸出**，然後重新執行筆記本儲存格。 ****

## JupyterLab 4.x 初始載入畫面延遲
<a name="graph-notebook-troubleshooting-loading-delay"></a>

在 JupyterLab 啟動後第一次開啟筆記本時，您可能會看到持續載入畫面，其中包含訊息： `Loading... The loading screen is taking a long time. Would you like to clear the workspace or keep waiting?`

這主要會影響 Firefox，而且只會發生在工作階段中開啟的第一個筆記本上。您可以選擇**清除工作區**、重新整理瀏覽器頁面，或直接重新開啟筆記本來解決此問題。

如果您使用 Firefox 並重複遇到這種情況，請嘗試在 Firefox 的**隱私權和安全**設定中清除 SageMaker AI 網域的 Cookie 和網站資料，然後重新整理 JupyterLab 頁面。

## Graph Explorer 存取問題
<a name="graph-notebook-troubleshooting-graph-explorer"></a>

筆記本重新啟動或使用快取的登入資料時，您可能無法存取 Graph Explorer。這可能會顯示為身分驗證錯誤、存取遭拒訊息，或 Graph Explorer 無法完全載入。

若要解決此問題，請嘗試清除您的瀏覽器快取和 Cookie。您也可以先開啟 JupyterLab 或 Jupyter Classic 以強制重新整理登入資料，然後開啟 Graph Explorer。如果問題仍然存在，請嘗試使用 incognito 或私有瀏覽器視窗。

## 一般提示
<a name="graph-notebook-troubleshooting-best-practices"></a>

許多筆記本問題與瀏覽器相關。若要將問題降至最低，請考慮下列事項：
+ 使用 Neptune 筆記本時定期清除瀏覽器快取。
+ 一律使用最新的筆記本工作階段，而不是重新開啟過時的工作階段。
+ 如果您遇到持久性問題，請使用 incognito 或私有瀏覽器視窗。
+ 將您的 JupyterLab 和圖形筆記本擴充功能保持在最新狀態。