Felsökning

Vanliga problem och lösningar när du arbetar med Aspose.PDF FOSS för .NET.

Problem	Orsak	Lösning
`Document.Open` kastar på en giltig PDF	Filen är lösenordsskyddad	Ange lösenordet i konstruktorn
Minnesbrist på stora PDF-filer	Hela filen läses in i en bytearray	Bearbeta sidor individuellt eller använd strömning
`Pages[0]` kastar indexfel	Sidor använder 1-baserad indexering	Använd `Pages[1]` för den första sidan

Problem	Orsak	Lösning
Anmärkning syns inte efter sparning	Rektangel har noll area eller är utanför sidans gränser	Verifiera att koordinaterna ligger inom sidan `MediaBox`
`LinkAnnotation.Uri` returnerar null	Länken använder en GoTo- eller JavaScript‑åtgärd	Lös via `PdfAction.Create` och kontrollera `ActionType`
`Flatten()` kastar	Anmärkning saknar `/P` (sid) referens	Säkerställ att anmärkning lades till via `Page.Annotations`

Problem	Orsak	Lösning
Extraherad text är förvrängd	Icke-standardkodning eller CID-typsnittsmappning	Kontrollera teckensnittsinbäddning; skannade PDF-filer kan behöva OCR
Inga textfragment hittades	Sidans innehåll är en rasterbild	Använd OCR innan textutdragning
Regex returnerar inga träffar	PDF-textlayout infogar blanksteg	Använd ett lösare mönster eller normalisera blanksteg

Problem	Orsak	Lösning
Renderad bild är suddig	Upplösning för låg	Öka DPI i `Resolution`-konstruktorn
HTML-utdata saknar bilder	Externa bildvägar är inte konfigurerade	Använd `HtmlSaveOptions` med inbäddade bilder
PDF/A-konvertering tar bort annotationer	Målsprofilen tillåter inte annotationer	Använd PDF/A-2 eller PDF/A-3

Problem	Orsak	Lösning
Fältvärdet är tomt	Fältet har ingen `/V` post	Kontrollera att `field.Value` inte är null
`FillField` har ingen effekt	Fältnamnet matchar inte	Använd `Form.FieldNames` för att lista tillgängliga namn
ExportToJson ger tomt resultat	Widget-annotation är inte korrekt kastad	Verifiera att annotationen är en `WidgetAnnotation`

Omslut alltid Document med using för att frigöra filhandtag.
Använd Document.Open(byte[]) för minnesbaserade arbetsflöden för att undvika fillås.
Kontrollera doc.Pages.Count innan du får åtkomst till sidor via index.
Spara dokumentet en gång efter alla ändringar för bästa prestanda.

Felsökning

Se även