[해결 방법] Plex '이 라이브러리를 로드하는 중 예기치 않은 오류가 발생했습니다' 오류 수정하기

Plex Media Player에서 '이 라이브러리를 로드하는 중 예기치 않은 오류가 발생했습니다(There Was an Unexpected Error Loading this Library)' 오류는 주로 사용자가 Plex Web에서 특정 라이브러리 섹션을 열려고 할 때 나타납니다. 이 문제는 특히 Windows 환경에서 자주 보고되고 있습니다.

이 오류를 유발하는 원인은 여러 가지가 있으며, 대표적인 원인은 다음과 같습니다:

• 최적화되지 않은 Plex 데이터베이스 – 잘못된 리소스를 가리키는 최적화되지 않은 데이터베이스가 가장 흔한 원인입니다. 다행히 Plex 계정의 서버 설정에서 데이터베이스 최적화를 직접 실행하면 쉽게 해결할 수 있습니다.
• 불완전한 메타데이터 – 서버가 일관성 없는 메타데이터를 처리하지 못해 문제가 발생하는 경우도 있습니다. 데이터베이스 문제보다는 덜 흔하지만, Plex 서버 설정에서 모든 메타데이터를 새로 고침하면 해결됩니다.
• Plex 서버에 관리자 권한이 없는 경우 – 메인 서버 실행 파일에 필요한 종속 요소에 접근할 권한이 없으면 이 문제가 발생할 수 있습니다. 이 경우 실행 파일을 관리자 권한으로 강제 실행하면 해결됩니다.
• Adblock 또는 uBlock의 간섭 – Adblock Plus나 uBlock 같은 확장 프로그램은 로컬에서 호스팅되는 Plex 서버와 충돌하는 경향이 있습니다. 해당 확장 프로그램을 비활성화하거나 제거하면 문제를 해결할 수 있습니다.
• 손상된 Plex 데이터베이스 – Plex 서버 데이터베이스 자체의 손상으로 인해 문제가 발생하기도 합니다. 이 경우 관리자 권한 명령 프롬프트에서 SQLite3 명령어를 실행해 자동으로 복구해야 합니다.

방법 1: 데이터베이스 최적화 실행

이 오류가 나타난다면 데이터베이스 최적화가 필요하다는 신호일 가능성이 높습니다. 실제로 많은 사용자가 오류가 발생한 라이브러리의 데이터베이스를 최적화한 후 문제를 해결했다고 확인했습니다.

아래 지침에 따라 Plex Media Player에서 데이터베이스 최적화를 진행해 보세요.

1. Plex.TV에 접속하여 계정 정보를 입력하고 로그인합니다.
2. 로그인에 성공하면 왼쪽 메뉴에서 해당 서버의 작업 아이콘을 클릭합니다.
3. 새로 나타난 컨텍스트 메뉴에서 서버 관리(Manage Server) 메뉴로 들어간 후 데이터베이스 최적화(Optimize Database)를 클릭합니다.
4. 최종 확인 화면에서 최적화(Optimize)를 클릭하여 절차를 시작하고 완료될 때까지 기다립니다. 서버 용량에 따라 몇 분 정도 걸릴 수 있습니다.
5. 작업이 완료되면 이전에 오류가 발생했던 동작을 다시 반복하여 문제가 해결되었는지 확인합니다.

동일한 문제가 계속 발생한다면 아래의 다음 해결 방법으로 넘어가세요.

방법 2: 전체 메타데이터 새로 고침

이 오류를 겪었던 일부 사용자는 Plex.TV 서버와 관련된 모든 메타데이터를 새로 고침하여 문제를 성공적으로 해결했습니다. 많은 사용자에게 효과가 입증된 방법입니다.

아래 지침에 따라 해당 섹션의 메타데이터를 새로 고쳐 보세요.

1. Plex.TV 계정에 접속하여 로그인합니다.
2. 로그인 후 왼쪽 메뉴에서 해당 서버의 작업 메뉴를 클릭합니다.
3. 모든 메타데이터 새로 고침(Refresh All Metadata)을 클릭하고 선택을 확인한 뒤 작업이 완료될 때까지 기다립니다.
4. 작업이 완료되면 Plex 서버를 재시작하고 문제가 해결되었는지 확인합니다.

여전히 동일한 오류가 발생한다면 다음 해결 방법으로 넘어가세요.

방법 3: 관리자 권한으로 Plex 서버 실행

로컬에 설치한 Plex 서버가 정상적으로 작동하기에 충분한 권한이 없는 경우에도 이 문제가 발생할 수 있습니다. 특히 UAC(사용자 계정 컨트롤) 규칙이 엄격하게 설정된 환경에서 자주 보고됩니다.

이 경우 Plex 실행 파일을 관리자 권한으로 실행한 후 오류가 발생했던 작업을 다시 시도하면 문제를 해결할 수 있습니다.

설치 경로를 따로 변경하지 않았다면 다음 위치에서 Plex 실행 파일을 찾을 수 있습니다:

C:\Program Files (x86)\Plex\Plex Media Server

해당 위치로 이동한 후 Plex Media Server.exe 파일을 마우스 오른쪽 버튼으로 클릭하고, 나타나는 컨텍스트 메뉴에서 관리자 권한으로 실행(Run as Administrator)을 선택합니다.

Plex 서버를 관리자 권한으로 실행한 후 이전에 오류를 일으켰던 작업을 반복하여 문제가 해결되었는지 확인하세요.

문제가 계속된다면 다음 해결 방법으로 넘어갑니다.

방법 4: Adblock Plus/uBlock 비활성화 (해당하는 경우)

브라우저(Chrome 또는 Firefox)에 Adblock Plus 또는 uBlock 플러그인이 설치되어 있다면, 로컬에서 호스팅 중인 Plex 서버와 충돌할 가능성이 있습니다. 이 경우 Plex 서비스를 이용하는 동안 해당 플러그인을 비활성화하면 문제를 해결할 수 있습니다.

실제로 여러 사용자가 Adblock Plus 또는 uBlock 플러그인을 비활성화한 후 오류가 더 이상 발생하지 않았다고 확인했습니다.

Chrome에서 Adblock 확장 프로그램을 비활성화하려면 주소창에 'chrome://extensions/'를 입력하고 Enter 키를 눌러 확장 프로그램 탭을 엽니다. 그런 다음 설치된 확장 프로그램 목록을 스크롤하여 AdBlock 또는 uBlock 확장 프로그램의 토글을 끕니다.

참고: Firefox에서는 주소창에 'about:addons'를 입력하고 Enter 키를 눌러 부가 기능 화면으로 이동합니다.

Adblock Plus 확장 프로그램을 비활성화하거나 제거한 후, 이전에 오류를 일으켰던 작업을 다시 시도하여 문제가 해결되었는지 확인합니다.

동일한 문제가 계속 발생한다면 마지막 해결 방법으로 넘어가세요.

방법 5: 손상된 데이터베이스 복구

위의 방법들이 모두 효과가 없었다면 Plex 서버 데이터베이스에 일종의 파일 손상이 발생했을 가능성이 높습니다. 이 경우 관리자 권한 명령 프롬프트에서 일련의 명령어를 실행하여 Plex 데이터베이스의 불일치를 복구할 수 있습니다.

참고: 이 작업을 시작하기 전에 컴퓨터에 SQLite3 도구가 설치되어 있는지 먼저 확인해야 합니다. 도구가 없으면 아래 명령어가 작동하지 않습니다.

준비가 되었다면 아래 지침에 따라 손상된 Plex 데이터베이스 복구를 진행하세요.

1. 먼저 로컬에 저장된 Plex Media Server가 종료되어 있는지 확인합니다.
2. Windows 키 + R을 눌러 실행 대화 상자를 엽니다. 텍스트 상자에 'cmd'를 입력하고 Ctrl + Shift + Enter를 눌러 관리자 권한 명령 프롬프트를 엽니다.

   참고: UAC(사용자 계정 컨트롤) 창이 나타나면 예를 클릭하여 관리자 권한을 부여합니다.

3. 관리자 권한 명령 프롬프트에서 다음 명령어를 순서대로 입력하고 각 명령어마다 Enter 키를 눌러 Plex 서버의 데이터베이스 복구를 시작합니다:

   cd "%LOCALAPPDATA%\Plex Media Server\Plug-in Support\Databases"
   
   copy com.plexapp.plugins.library.db com.plexapp.plugins.library.db.original
   
   sqlite3 com.plexapp.plugins.library.db "DROP index 'index_title_sort_naturalsort'"
   
   sqlite3 com.plexapp.plugins.library.db "DELETE from schema_migrations where version='20180501000000'"
   
   sqlite3 com.plexapp.plugins.library.db .dump > dump.sql
   
   del com.plexapp.plugins.library.db
   
   sqlite3 com.plexapp.plugins.library.db < dump.sql

   참고: 특정 명령어 입력 중 오류가 발생해도 걱정하지 마세요. 예상된 현상입니다.

4. 모든 명령어를 입력한 후 관리자 권한 명령 프롬프트를 닫고 컴퓨터를 재시작합니다.
5. 재부팅이 완료되면 Plex.TV 라이브러리를 열어 오류가 해결되었는지 확인합니다.