

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 对亚马逊 Neptune 笔记本问题进行故障排除
<a name="graph-notebook-troubleshooting"></a>

在中使用 Neptune 笔记本电脑时 JupyterLab，您偶尔可能会遇到与浏览器行为、 JupyterLab 本身或 Amazon A SageMaker I 集成有关的问题。以下各节描述了最常见的问题以及如何解决这些问题。

## 控件状态不同步
<a name="graph-notebook-troubleshooting-widget-state"></a>

Graph-notebook 控件有时会在 JupyterLab 用户界面和内核后端之间不同步。发生这种情况时，您可能会看到小组件显示错误或类似以下的错误消息：

```
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 

## 图表资源管理器访问问题
<a name="graph-notebook-troubleshooting-graph-explorer"></a>

笔记本重启后或使用缓存的凭据时，您可能无法访问 Graph Explorer。这可能显示为身份验证错误、访问被拒绝的消息或 Graph Explorer 无法完全加载。

要解决此问题，请尝试清除浏览器缓存和 Cookie。你也可以先打开 JupyterLab 或 Jupyter Classic 来强制刷新凭据，然后打开 Graph Explorer。如果问题仍然存在，请尝试使用隐身或私密浏览器窗口。

## 一般小贴士
<a name="graph-notebook-troubleshooting-best-practices"></a>

许多笔记本问题都与浏览器有关。要最大限度地减少问题，请考虑以下几点：
+ 使用 Neptune 笔记本电脑时，请定期清除浏览器缓存。
+ 请务必使用最新的笔记本会话，而不是重新打开陈旧的会话。
+ 如果您遇到持续存在的问题，请使用隐身或私密浏览器窗口。
+ 让你的 JupyterLab 和图形笔记本扩展保持最新。