Fehlerbehebung

Häufige Probleme und Lösungen bei der Arbeit mit Aspose.PDF FOSS für .NET.

Problem	Ursache	Lösung
`Document.Open` wirft bei einer gültigen PDF	Datei ist passwortgeschützt	Geben Sie das Passwort im Konstruktor an
Speicherüberlauf bei großen PDFs	Gesamte Datei in ein Byte‑Array geladen	Verarbeiten Sie Seiten einzeln oder verwenden Sie Streaming
`Pages[0]` wirft Indexfehler	Seiten verwenden 1‑basierte Indizierung	Verwenden Sie `Pages[1]` für die erste Seite

Problem	Ursache	Lösung
Annotation nach dem Speichern nicht sichtbar	Rechteck hat null Fläche oder liegt außerhalb der Seitenränder	Stellen Sie sicher, dass die Koordinaten innerhalb der Seite liegen `MediaBox`
`LinkAnnotation.Uri` gibt null zurück	Link verwendet eine GoTo- oder JavaScript-Aktion	Lösen Sie es über `PdfAction.Create` und prüfen Sie `ActionType`
`Flatten()` wirft	Annotation fehlt `/P` (Seiten-)Referenz	Stellen Sie sicher, dass die Annotation über `Page.Annotations` hinzugefügt wurde

Problem	Ursache	Lösung
Extrahierter Text ist verzerrt	Nichtstandard‑Kodierung oder CID‑Schriftzuordnung	Schriftart‑Einbettung prüfen; gescannte PDFs benötigen ggf. OCR
Keine Textfragmente gefunden	Seiteninhalt ist ein Rasterbild	OCR vor der Textextraktion verwenden
Regex liefert keine Treffer	PDF‑Textlayout fügt Leerzeichen ein	Ein lockeres Muster verwenden oder Leerzeichen normalisieren

Problem	Ursache	Lösung
Gerendertes Bild ist unscharf	Auflösung zu niedrig	Erhöhen Sie die DPI im `Resolution`-Konstruktor
HTML-Ausgabe enthält keine Bilder	Externe Bildpfade nicht konfiguriert	Verwenden Sie `HtmlSaveOptions` mit eingebetteten Bildern
PDF/A-Konvertierung entfernt Anmerkungen	Zielprofil erlaubt keine Anmerkungen	Verwenden Sie PDF/A-2 oder PDF/A-3

Problem	Ursache	Lösung
Feldwert ist leer	Feld hat keinen `/V` Eintrag	Überprüfen Sie, dass `field.Value` nicht null ist
`FillField` hat keine Wirkung	Feldnamen stimmen nicht überein	Verwenden Sie `Form.FieldNames`, um verfügbare Namen aufzulisten
ExportToJson erzeugt leere Ausgabe	Widget-Annotation nicht korrekt umgewandelt	Stellen Sie sicher, dass die Annotation ein(e) `WidgetAnnotation` ist

Um Dateihandles freizugeben, immer Document in using einwickeln.
Verwenden Sie Document.Open(byte[]) für In‑Memory‑Workflows, um Dateisperren zu vermeiden.
Überprüfen Sie doc.Pages.Count, bevor Sie Seiten nach Index zugreifen.
Speichern Sie das Dokument einmal nach allen Änderungen für optimale Leistung.

Fehlerbehebung

Siehe auch