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

# 问题排查
<a name="studio-lab-troubleshooting"></a>

该指南显示了使用亚马逊 SageMaker Studio 实验室（Studio Lab）时可能发生的常见错误。每个错误都包含描述以及错误的解决方案。

**注意**  
您不能与多个用户共享密码，也不能使用 Studio Lab 挖掘加密货币。由于运行时系统限制，我们不建议将 Studio Lab 用于生产任务。

 **依赖项问题** 

2025 年 8 月 8 日，Studio Lab 从 JupyterLab 3 迁移到 JupyterLab 4。有关 JupyterLab 4 的信息，请参阅变更日志中的 [4.0.0-亮点](https://jupyterlab.readthedocs.io/en/4.0.x/getting_started/changelog.html#highlights)。 JupyterLab 如果您在 2025 年 8 月 8 日之前在 Studio Lab 环境中安装了 JupyterLab扩展，则可能需要在 JupyterLab 4 环境中重新安装这些扩展。

 **无法访问账户** 

如果您无法访问自己的账户，请验证您使用的电子邮件和密码是否正确。如果您忘记了密码，请使用以下步骤重置密码。如果您仍然无法访问自己的账户，则必须按照[登上亚马逊 SageMaker Studio 实验室](studio-lab-onboard.md)中的说明申请并注册新账户。

 **忘记密码** 

如果您忘记了密码，则必须使用以下步骤重置密码。

1. 导航到 [Studio Lab 登录页面](https://studiolab.sagemaker.aws)。

1. 选择**登录**。

1. 选择**忘记密码？**以打开新页面。

1. 输入您注册账户时使用的电子邮件地址。

1. 选择**发送重置链接**以发送带有密码重置链接的电子邮件。

1. 从密码重置电子邮件中，选择**重置密码**。

1. 输入您的新密码。

1. 选择**提交**。

 **无法启动项目运行时系统** 

如果 Studio Lab 项目运行时系统未启动，请尝试再次启动。如果这不起作用，请将实例类型从 CPU 切换到 GPU（或反过来）。有关更多信息，请参阅 [更改计算类型](studio-lab-manage-runtime.md#studio-lab-manage-runtime-change)。

 **运行时系统意外停止运行** 

如果用于运行的环境出现问题 JupyterLab，Studio Lab 将自动重新创建环境。Studio Lab 不支持手动激活此过程。

 **版本冲突** 

由于您可以根据需要添加软件包和修改环境，因此环境中的软件包之间可能会发生冲突。如果环境中的软件包之间存在冲突，则必须删除冲突的软件包。

 **环境构建失败** 

从 YAML 文件构建环境时，软件包版本冲突或文件问题可能会导致构建失败。要解决此问题，请运行以下命令删除环境。在尝试再次构建环境之前，请执行此操作。

```
conda remove --name <YOUR_ENVIRONMENT> --all
```

 **关于允许从 \$1.awswaf.com 域下载脚本的错误信息** 

Studio Classic 使用 Web 应用程序防火墙服务 AWS WAF 来保护您的资源，该服务使用 JavaScript。如果您使用的是 JavaScript 阻止下载的浏览器安全插件，则可能会弹出此错误。要使用 Studio Classic，请允许从\$1.awswaf.com 作为可信域名进行 JavaScript 下载。有关的更多信息 AWS WAF，请参阅[AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html) AWS WAF AWS Firewall Manager、和 AWS Shield Advanced。开发人员指南。

 **磁盘空间已满** 

如果您在尝试打开文件时遇到提及磁盘空间已满或**文件加载错误的**通知，*<FILE\$1NAME>*则可以删除文件、目录、库或环境以增加空间。有关管理库和环境的更多信息，请参阅[管理环境](studio-lab-use-manage.md)。

 ****项目运行时系统处于安全模式**通知** 

如果您收到**项目运行时系统处于安全模式**的通知，则必须释放一些磁盘空间才能继续使用 Studio Lab 项目运行时系统。按照前面的问题排查项**磁盘空间已满**中的说明进行操作。一旦清理了至少 500 MB 的空间，您就可以重新启动项目运行时系统来使用 Studio Lab。这可以通过在 ** SageMaker Studio Lab 的顶部菜单中选择 Amazon St** udio Lab 然后选择**重启来完成 JupyterLab...** 。

git **无法导入 `cv2`** 

如果在安装 `opencv-python` 后导入 `cv2` 时遇到错误，则必须按如下方式卸载 `opencv-python` 和安装 `opencv-python-headless`。

```
%pip uninstall opencv-python --yes
%pip install opencv-python-headless
```

然后可以按预期导入 `cv2`。

 **Studio Lab 在打开大文件时变得无响应** 

打开大文件时，Studio Lab IDE 可能无法渲染，导致对 Studio Lab 资源的访问受阻。要解决此问题，请使用以下步骤重置 Studio Lab 工作区。

1. 打开 IDE 后，在浏览器地址栏中复制 URL。该 URL 的格式应为 `https://xxxxxx.studio.us-east-2.sagemaker.aws/studiolab/default/jupyter/lab`。关闭标签页。

1. 在新标签页中，粘贴 URL 并删除 `https://xxxxxx.studio.us-east-2.sagemaker.aws/studiolab/default/jupyter/lab` 后的内容。

1. 将 `?reset` 添加到 URL 的末尾，使其格式为 `https://xxxxxx.studio.us-east-2.sagemaker.aws/studiolab/default/jupyter/lab?reset`。

1. 导航到更新后的 URL。这将重置已保存的用户界面状态并使 Studio Lab IDE 具有响应能力。