RAW 썸네일은 브라우저에서는 정상적으로 작동하지만 모바일에서는 작동하지 않을 수 있습니다. 두 클라이언트가 서로 다른 미리보기, 파생 파일, 크기 또는 디코더 경로를 요청할 수 있기 때문입니다.
먼저 같은 라이브러리에서 정상적으로 작동하는 RAW 파일 하나와 실패하는 RAW 파일 하나를 준비하세요. 웹과 모바일에서 발생하는 정확한 썸네일 요청을 비교한 다음, 카메라에 포함된 미리보기와 서버에서 렌더링한 파생 파일, 모바일 로컬 캐시를 구분하세요. 원본 RAW 파일은 완전히 정상인데 특정 표시 경로만 손상되었을 수 있습니다.
모바일에서 다른 미리보기를 요청하는지 확인하세요
로그 또는 요청 경로를 캡처하면서 웹 인터페이스와 모바일 앱에서 동일한 RAW 자산을 여세요. 요청된 썸네일 크기, 확장자, 응답 코드, 모바일 클라이언트가 원본으로 대체 표시하는지 여부를 비교하세요.
많은 RAW 파일에는 JPEG 미리보기가 포함되어 있습니다. 웹 클라이언트는 이 내장 이미지를 표시하는 반면, 다른 클라이언트는 서버에 별도로 생성된 파생 파일을 요청할 수 있습니다.
두 클라이언트가 서로 다른 객체를 요청한다면 이 증상을 하나의 보편적인 RAW 디코딩 실패로 취급하지 마세요. 다음 테스트는 모바일에서만 사용하는 파생 파일 또는 클라이언트 경로를 대상으로 해야 합니다.
내장 미리보기와 서버 렌더링을 비교하세요
RAW 파일의 내장 미리보기를 추출하거나 검사한 다음, 서버에서 생성한 썸네일과 비교하세요. 내장 JPEG는 정상인데 생성된 썸네일이 실패한다면 서로 다른 코드 경로가 사용되고 있다는 뜻입니다.
사진 관리 도구는 내장 JPEG 미리보기와 렌더링된 RAW 데이터에 대해 서로 다른 RAW 렌더링 동작을 설명합니다. 따라서 한 썸네일 경로가 성공했다고 해서 다른 경로까지 검증된 것은 아닙니다.
생성된 썸네일만 실패한다면 서버 디코더와 파생 파일 작업을 점검하세요. 내장 미리보기만 잘못 표시된다면 서버를 변경하기 전에 같은 카메라로 촬영한 다른 파일을 테스트하세요.
확장자가 아니라 RAW 변형을 확인하세요
카메라 모델, 펌웨어, RAW 압축 모드, 비트 깊이, 실패한 파일이 네이티브 RAW인지 DNG인지 또는 휴대폰 전용 RAW 변형인지 기록하세요. 정상적으로 작동하는 샘플 하나와 비교하세요.
DNG에도 서로 다른 미리보기 및 이미지 구조가 포함될 수 있습니다. 따라서 DNG 미리보기 차이를 확인하는 것이, 같은 확장자를 가진 모든 파일이 동일한 디코딩 경로를 통해 클라이언트에 전달된다고 가정하는 것보다 정확합니다.
특정 카메라에서만 문제가 발생한다면 유용한 증거가 됩니다. 해당 변형을 처리하지 못하는 디코더 구성 요소만 업데이트하거나 교체하고, 원본 RAW 파일은 보존한 채 호환 가능한 파생 파일을 생성하세요.
손상된 모바일 캐시 계층만 삭제하세요
서버 로그에 썸네일이 성공적으로 생성된 것으로 표시된다면 캐시를 비활성화한 상태, 앱 캐시를 선택적으로 삭제한 후 또는 다른 기기에서 모바일 자산을 테스트하세요. 먼저 서버의 전체 썸네일 저장소를 삭제하지 마세요.
ProRAW 처리 경로와 같은 휴대폰 RAW 작업은 표시 전에 또 다른 처리 계층을 추가합니다. 따라서 동일한 원본 파일이라도 클라이언트 디코더와 캐시된 파생 파일의 동작이 데스크톱 브라우저와 다를 수 있습니다.
두 번째 모바일 기기에서 정상적으로 작동한다면 로컬 캐시 또는 앱 버전에 집중하세요. 모든 모바일 기기에서 동일한 파생 파일 URL이 실패한다면 클라이언트를 반복해서 재설치하지 말고 서버 응답을 다시 확인하세요.
파생 파일 하나를 다시 생성하고 재테스트하세요
애플리케이션에서 지원하는 절차를 사용해 통제된 RAW 자산 하나에 대해 실패한 파생 파일만 삭제하거나 무효화한 다음, 서버가 다시 생성하도록 하세요. 새 객체의 크기와 응답을 기록하세요.
Immich 가족 사진 라이브러리에 관한 ZimaSpace 가이드는 원본을 보존하고 파생 파일 재생성을 일회성 작업으로 처리해야 한다는 관련 원칙을 제공합니다. 미리보기 문제를 사진 손실 사고로 확대하지 마세요.
캐시 만료, 앱 재시작, 새 서버 요청 이후 동일한 RAW 파일이 웹과 모바일에서 모두 표시될 때만 문제가 해결되었다고 판단하세요. 다시 생성한 파생 파일도 계속 실패한다면 디코더 수준에서 비교할 수 있도록 보존하세요.
자주 묻는 질문
브라우저 썸네일은 정상인데 모바일 앱에서는 아무것도 표시되지 않는 이유는 무엇인가요?
두 클라이언트가 서로 다른 파생 파일, 크기, 형식 또는 캐시 항목을 요청할 수 있습니다. 따라서 브라우저 미리보기가 유효하다고 해서 모바일 미리보기 객체도 정상이라고 단정할 수는 없습니다.
모바일에서 보기 위해 RAW 파일을 JPEG로 변환해야 하나요?
첫 번째 해결 방법으로 변환할 필요는 없습니다. 원본 아카이브를 복제하거나 변환하기 전에 내장 미리보기 또는 생성된 파생 파일 중 어느 계층에서 문제가 발생하는지 확인하세요.
한 카메라 모델에서는 문제가 발생하지만 다른 모델에서는 발생하지 않을 수 있나요?
그럴 수 있습니다. RAW 형식과 내장 미리보기 방식은 카메라 모델과 펌웨어에 따라 다르므로, 모든 RAW 파일을 동일하게 취급하지 말고 정상 파일 하나와 실패 파일 하나를 비교하세요.
지원 및 팁
더 읽어보기

Plex가 다른 Docker 컨테이너와 GPU를 공유할 수 있나요?
Plex와 다른 컨테이너가 동일한 GPU에 함께 액세스할 수 있는 경우가 많지만, 드라이버 지원, 디바이스 매핑, 비디오 엔진 부하, 메모리, 복구 동작을 테스트해야 합니다.

Plex 오류가 클라이언트에서 발생한 것인지 서버에서 발생한 것인지 확인하는 방법
다른 클라이언트에서 동일한 항목을 재현하고, 세션 경로를 비교한 다음, 범위 분석을 통해 장애가 실제로 발생한 위치를 확인한 후에만 서버 증거를 수집하세요.

Plex 캐시 및 트랜스코딩 임시 저장소 구성 방법
영구 Plex 상태는 보호하면서 트랜스코딩 임시 파일은 적합한 로컬 저장소에 배치한 다음, 정리 상태와 여유 공간 및 재시작 동작을 확인하세요.

