Awaria, zawieszenie lub pusty plik PDF na Linux z podłączonym debugerem

Curtis Chau
Curtis Chau
Zaktualizowano: 3 lipca 2026

Na Linux, podłączenie debugera do aplikacji może spowodować zawieszenie IronPDF, zwrócenie pustego pliku PDF lub cichą awarię. Dzieje się to zawsze, gdy dołączony jest debuger, niezależnie od dystrybucji Linux ani wersji .NET.

IronPDF renderuje za pomocą CEF (Chromium Embedded Framework), który domyślnie uruchamia osobne, działa w piaskownicy procesy podrzędne do obsługi renderowania. Na systemie Linux te podprocesy są zablokowane, więc nie można ich śledzić za pomocą ptrace, a proces może mieć tylko jeden śledzący na raz. Podłączenie debuggera koliduje ze sposobem, w jaki Chromium uruchamia swoje izolowane podrzędne procesy, co powoduje zawieszenie się podprocesów renderujących. Twoja aplikacja widzi to jako zawieszenie, pusty plik PDF lub cichą awarię.

Rozwiązanie

Zalecane: włącz tryb jednego procesu. Ustaw go podczas uruchamiania aplikacji, przed pierwszą operacją IronPDF:

IronPdf.Installation.SingleProcess = true;

Tryb jednego procesu utrzymuje renderowanie w głównym procesie, więc nie ma dziecka sandboxa, z którym debuger mógłby kolidować.

Ponieważ to ustawienie wyłącza izolację procesów CEF i jest mniej stabilne pod obciążeniem, nie używaj go w produkcji. Ogranicz to do kompilacji debugowania, aby nigdy nie było wysyłane w wersji:

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
Ostrzeżenie: Tryb jednego procesu wyłącza izolację procesów CEF i jest mniej stabilny przy obciążeniu. Usuń to lub wyklucz z kompilacji do produkcji przed wdrożeniem.

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 22,198,312Wersja:2026.11właśnie wydane