Absturz, Hängen oder Leeres PDF auf Linux mit angehängtem Debugger

Curtis Chau
Curtis Chau
Aktualisiert: 3. Juli 2026

Unter Linux kann das Anhängen eines Debuggers an Ihre Anwendung dazu führen, dass IronPDF hängen bleibt, ein leeres PDF zurückgibt oder ohne Fehlermeldung abstürzt. Es passiert immer, wenn ein Debugger angehängt ist, unabhängig von der Linux-Distribution oder .NET-Version.

IronPDF rendert über CEF (Chromium Embedded Framework), das standardmäßig separate, sandboxed Unterprozesse erstellt, um das Rendering zu verwalten. Unter Linux sind diese Subprozesse gesperrt, sodass sie nicht mit ptrace nachverfolgt werden können, und ein Prozess kann jeweils nur einen Tracer haben. Das Anfügen eines Debuggers kollidiert mit der Art und Weise, wie Chromium seine isolierten Kindprozesse startet, sodass die Renderer-Subprozesse hängen bleiben. Ihre Anwendung sieht das als Hängenbleiben, als leeres PDF oder als stillen Absturz.

Lösung

Empfohlen: Aktivieren Sie den Einzelnutzermodus. Setzen Sie es beim Start der Anwendung, bevor Sie Ihre erste IronPDF-Operation ausführen:

IronPdf.Installation.SingleProcess = true;

Der Einzelnutzermodus hält das Rendering im Hauptprozess, sodass es kein sandboxed Kind gibt, mit dem der Debugger kollidieren könnte.

Da diese Einstellung die Prozessisolierung von CEF deaktiviert und unter Last weniger stabil ist, halten Sie sie aus der Produktion heraus. Beschränken Sie es auf Debug-Builds, sodass es niemals in einem Release veröffentlicht wird:

#if DEBUG
IronPdf.Installation.SingleProcess = true;
#endif
Warnung: Der Ein-Prozess-Modus deaktiviert die Prozessisolation von CEF und ist unter Last weniger stabil. Entfernen Sie es oder schließen Sie es aus den Release-Builds aus, bevor Sie es bereitstellen.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 22,198,312Version:2026.11gerade veröffentlicht