

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 문제 해결
<a name="studio-lab-troubleshooting"></a>

이 안내서에는 Amazon SageMaker Studio Lab(Studio Lab)을 사용할 때 발생할 수 있는 일반적인 오류가 나와 있습니다. 각 오류에는 설명과 오류 해결 방법이 포함되어 있습니다.

**참고**  
암호를 여러 사용자와 공유하거나 Studio Lab을 사용하여 가상화폐를 채굴할 수 없습니다. 런타임 제한 때문에 프로덕션 작업에는 Studio Lab을 사용하지 않는 것이 좋습니다.

 **종속성 문제** 

2025년 8월 8일에 Studio Lab은 JupyterLab 3에서 JupyterLab 4로 마이그레이션했습니다. JupyterLab 4에 대한 자세한 내용은 JupyterLab Changelog의 [4.0.0 - Highlights](https://jupyterlab.readthedocs.io/en/4.0.x/getting_started/changelog.html#highlights)를 참조하세요. 2025년 8월 8일 전에 Studio Lab 환경에 JupyterLab 확장을 설치한 경우 JupyterLab 4 환경에 다시 설치해야 할 수 있습니다.

 **계정에 액세스할 수 없습니다.**

계정에 접근할 수 없는 경우 올바른 이메일과 암호를 사용하고 있는지 확인하세요. 암호를 잊어버린 경우 다음 단계에 따라 비밀번호를 재설정하세요. 그래도 계정에 액세스할 수 없는 경우 [Amazon SageMaker Studio Lab에 온보딩하기](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은 웹 애플리케이션 방화벽 서비스를 AWS WAF 사용하여 JavaScript를 사용하는 리소스를 보호합니다. JavaScript가 다운로드되지 않도록 하는 브라우저 보안 플러그인을 사용하는 경우 이 오류가 표시될 수 있습니다. Studio Classic을 사용하려면 \$1.awswaf.com에서 JavaScript를 신뢰할 수 있는 도메인으로 다운로드하도록 허용하세요. 에 대한 자세한 내용은 AWS WAF및 AWS Firewall Manager[AWS WAF](https://docs.aws.amazon.com/waf/latest/developerguide/waf-chapter.html)의 섹션을 AWS WAF참조하세요 AWS Shield Advanced. 개발자 안내서 

 **디스크 공간이 꽉 찼습니다.**

파일을 열려고 시도하는 동안 디스크 공간이 꽉 찼거나 ***<FILE\$1NAME>*에 대해 파일 로드 오류**가 발생했다는 알림이 표시되면 파일, 디렉터리, 라이브러리 또는 환경을 제거하여 공간을 늘릴 수 있습니다. 라이브러리 및 환경 관리에 관한 자세한 내용은 [환경 관리](studio-lab-use-manage.md)을 참조하세요.

 ****프로젝트 런타임이 안전 모드 상태입니다** 알림** 

**Project 런타임이 안전 모드 상태입니다**라는 알림이 표시되면 Studio Lab 프로젝트 런타임 사용을 재개하기 위해 디스크 공간을 확보해야 합니다. 앞의 문제 해결 항목인 **디스크 공간이 꽉 찼습니다**의 지침을 따르세요. 최소 500MB의 공간이 비워지면 프로젝트 런타임을 다시 시작하여 Studio Lab을 사용할 수 있습니다. 이를 수행하려면 Studio Lab의 상단 메뉴에서 **Amazon SageMaker Studio 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. URL 끝에 `?reset`을 추가하여 `https://xxxxxx.studio.us-east-2.sagemaker.aws/studiolab/default/jupyter/lab?reset` 형식이 되도록 합니다.

1. 업데이트된 URL로 이동합니다. 이렇게 하면 저장된 UI 상태가 재설정되고 Studio Lab IDE가 반응하게 됩니다.