Przetestuj jeden plik RAW z użyciem tego samego dekodera poza kolejką, a następnie porównaj przydział zadań pracownikom i dzienniki zadań, aby odróżnić brak obsługi formatu od błędu wykonania.
Decyzja ma znaczenie, gdy oryginalne pliki RAW importują się pomyślnie, ale podglądy pozostają puste lub oczekujące. Dwa konkurencyjne stany to nieobsługiwane lub nieudane dekodowanie RAW oraz awaria kolejki miniatur, pracownika, uprawnień lub magazynu wynikowego. Zacznij od zapisanej konfiguracji i danych tymczasowych, obserwuj jedną gałąź naraz i przerwij, jeśli test zwiększa ryzyko utraty danych, problemów z uprawnieniami lub dostępnością.
Odróżnij nieobsługiwane lub nieudane dekodowanie RAW od awarii kolejki miniatur, pracownika, uprawnień lub magazynu wynikowego
Zapisz stan środowiska przed wprowadzeniem zmian: wersje oprogramowania i firmware’u, tożsamości urządzeń, ścieżkę montowania lub sieciową, wolne miejsce, uprawnienia oraz obserwowany objaw. Stan bazowy musi zachować wystarczająco dużo szczegółów, aby odtworzyć sytuację, w której oryginalne pliki RAW importują się pomyślnie, ale podglądy pozostają puste lub oczekujące.
Pierwszym podejrzanym jest nieobsługiwane lub nieudane dekodowanie RAW. Drugim jest awaria kolejki miniatur, pracownika, uprawnień lub magazynu wynikowego. Aktualna lista obsługiwanych typów multimediów w Immich definiuje mechanizm lub granicę polecenia używaną w teście; nie zastępuje obserwacji z tego konkretnego serwera domowego.
Zapisz warunek akceptacji i warunek przerwania przed uruchomieniem testu rozstrzygającego. Wynik pozytywny musi zmienić dowody przewidywane przez jedną gałąź, pozostawiając niepowiązane usługi bez zmian; wynik negatywny musi przywrócić system do zapisanego stanu, zamiast uruchamiać ciąg spekulatywnych napraw.
Przeprowadź jeden kontrolowany test rozstrzygający
Użyj następującego testu rozstrzygającego: uruchom testy metadanych i dekodowania na jednej skopiowanej próbce RAW, dodaj jedno zadanie tworzenia miniatury do kolejki i prześledź je od kolejki do pliku wynikowego. Zachowaj stałe obciążenie, klienta, ścieżkę, zestaw plików i czas, aby wynik można było przypisać zmiennej, która uległa zmianie.
Użyj obsługi dekoderów libvips, aby wybrać parametr, który rzeczywiście może rozdzielić te gałęzie, a następnie zarejestruj jego znacznik czasu, kod wyjścia, treść błędu, tożsamość urządzenia lub migawki, opóźnienie, przesłane bajty, uprawnienia i stan odzyskiwania. Pomyślne zakończenie polecenia nie wystarcza, gdy testowane twierdzenie dotyczy tożsamości, trwałości lub stanu aplikacji.
Powtórz test raz po ponownym uruchomieniu, ponownym połączeniu, ponownym zamontowaniu lub wyczyszczeniu pamięci podręcznej, jeśli takie zdarzenie było częścią pierwotnego warunku. Jeśli pierwszy przebieg jest destrukcyjny lub nie można przywrócić środowiska, przerwij i odtwórz test na jednorazowej kopii.
exiftool sample.CR3
# Zdekoduj kopię za pomocą zainstalowanego stosu obrazów, a następnie dodaj jedno zadanie tworzenia miniatury do kolejki
Zinterpretuj, którą gałąź potwierdzają dowody
WYNIK POZYTYWNY: dekoder kończy działanie błędem przed rozpoczęciem pracy kolejki albo dekodowanie kończy się pomyślnie, lecz pracownik nigdy nie zapisuje pochodnego pliku. Zapisz dokładną wersję, tożsamość i obciążenie, dla których test zakończył się pomyślnie, aby wniosek pozostał warunkowy, a nie stał się twierdzeniem uniwersalnym.
WYNIK NEGATYWNY: nie działa tylko jeden aparat lub tryb kompresji, więc obsługę należy ograniczyć do tej próbki. Wynik negatywny nie dowodzi automatycznie przeciwnej gałęzi, gdy na obie mogą wpływać sieć, pamięć, uprawnienia lub spójność źródła; przed eskalacją odizoluj te wspólne zależności.
WYJĄTEK LUB NIEJEDNOZNACZNY WYNIK: zachowaj oryginały, przerwij lawinowe ponawianie prób i pozostaw sprawdzoną ścieżkę podglądów JPEG na czas dochodzenia. Zachowaj dzienniki i nie uruchamiaj poleceń naprawczych, czyszczących, niszczących, partycjonujących ani rekurencyjnie zmieniających właściciela, dopóki nie będzie dostępna kopia możliwa do odzyskania.
Zastosuj dopasowane działanie i odtwórz pierwotny błąd
Zastosuj działanie dopasowane do zaobserwowanej gałęzi, a następnie powtórz pierwotny warunek, a nie jego uproszczony zamiennik. Wniosek jest wiarygodny tylko wtedy, gdy dekoder kończy działanie błędem przed rozpoczęciem pracy kolejki albo dekodowanie kończy się pomyślnie, lecz pracownik nigdy nie zapisuje pochodnego pliku w dwóch cyklach lub podczas odpowiedniego ponownego uruchomienia, uśpienia, przerwania albo przejścia obciążenia.
Użyj bibliotek Immich tylko do odczytu, aby sprawdzić najbliższy zależny przepływ pracy, ale zachowaj niezmieniony pierwotny wyzwalacz. Niepowiązane zestawy danych, udziały, kontenery, użytkownicy i punkty odzyskiwania muszą zachować wcześniejszy dostęp i harmonogram.
Granica przerwania jest jednoznaczna: jeśli nie działa tylko jeden aparat lub tryb kompresji, więc obsługę należy ograniczyć do tej próbki, wróć do ostatniej zweryfikowanej konfiguracji, zachowaj dowody i eskaluj do głębszego testu platformy lub sprzętu tylko wtedy, gdy gałąź daje się odtworzyć.
Gdy docelowy wynik się utrzyma, porównaj go z harmonogramowaniem zadań tworzenia miniatur, aby naprawa nie przeniosła ryzyka do sąsiedniej usługi. Pomyślny test docelowy z nową awarią kopii zapasowej, tożsamości, limitu czasu lub dostępności nadal oznacza nieudaną zmianę.
Najczęściej zadawane pytania
W przypadku diagnozowania brakujących podglądów RAW pozostałe wyszukiwania zwykle dotyczą tego, dlaczego niektóre pliki RAW z jednego aparatu działają, czy uprawnienia pliku mogą wyglądać poprawnie, a pracownicy mimo to kończyć działanie błędem, oraz czy należy ponownie wygenerować podglądy dla całej biblioteki. Poniższe odpowiedzi oddzielają te przypadki brzegowe od głównej decyzji.
Granica akceptacji nie ulega zmianie: dekoder kończy działanie błędem przed rozpoczęciem pracy kolejki albo dekodowanie kończy się pomyślnie, lecz pracownik nigdy nie zapisuje pochodnego pliku. Jeśli kolejny warunek zmienia system plików, tożsamość, ścieżkę sieciową lub wersję aplikacji, powtórz tylko test rozstrzygający, którego dotyczy ta zmiana.
Przestań rozszerzać eksperyment, gdy nie działa tylko jeden aparat lub tryb kompresji, więc obsługę należy ograniczyć do tej próbki. W tym momencie zachowaj oryginały, przerwij lawinowe ponawianie prób i pozostaw sprawdzoną ścieżkę podglądów JPEG na czas dochodzenia; zachowaj dowody przed eskalacją do właściciela platformy, magazynu lub sprzętu.
Dlaczego niektóre pliki RAW z jednego aparatu działają?
Firmware aparatu, tryb kompresji, osadzony podgląd i wersja dekodera mogą się różnić mimo tego samego rozszerzenia.
Czy uprawnienia pliku mogą wyglądać poprawnie, a pracownicy mimo to kończyć działanie błędem?
Tak. Pracownik może używać innej ścieżki kontenera, identyfikatora UID lub montowania wyjściowego.
Czy należy ponownie wygenerować podglądy dla całej biblioteki?
Nie, dopóki jedna próbka nie zadziała, a zapas mocy kolejki i magazynu nie będzie wystarczający do obsługi tego obciążenia.
Diagnoza jest zakończona, gdy to samo obciążenie powoduje, że dowody wskazują na nieobsługiwane lub nieudane dekodowanie RAW albo awarię kolejki miniatur, pracownika, uprawnień lub magazynu wynikowego, a dopasowane działanie usuwa pierwotny objaw bez tworzenia drugiego. Jeśli żadna gałąź nie pozostaje powtarzalna, zachowaj dzienniki i zapisany stan bez zmian; niepewność jest powodem do eskalacji, a nie do nakładania kolejnych poprawek.
Wsparcie i wskazówki
Więcej do przeczytania

Przewodnik po pamięci masowej nagrywania telewizji na żywo: pojemność, przechowywanie i czyszczenie
Zmierz rzeczywiste nagrania, zarezerwuj zapas, połącz limity wieku i pojemności oraz potwierdź, że najstarszy kwalifikujący się program zostanie usunięty, zanim pamięć się zapełni.

Proces odzyskiwania metadanych multimediów domowych po przywróceniu bazy danych
Zabezpiecz przywrócony stan, zweryfikuj tożsamość multimediów i ścieżki, a następnie napraw brakujące grafiki lub dopasowania w pilotażowej bibliotece przed wprowadzeniem szeroko zakrojonych zmian metadanych.

Lista zgodności klientów Jellyfin z dźwiękiem, obrazem i napisami
Testuj reprezentatywne pliki, zmieniając jedną zmienną naraz, i rejestruj dla każdego klienta: bezpośrednie odtwarzanie, remultipleksowanie, konwersję dźwięku, transkodowanie wideo lub niepowodzenie.

