Depanare

Probleme comune și soluții când lucraţi cu Aspose.PDF FOSS pentru .NET.

Problem	Cause	Solution
`Document.Open` aruncă o excepție pe un PDF valid	Fișierul este protejat prin parolă	Furnizați parola în constructor
Memorie insuficientă la PDF-uri mari	Întregul fișier este încărcat într-un tablou de octeți	Procesați paginile individual sau utilizați streaming
`Pages[0]` aruncă o eroare de index	Paginile folosesc indexare începând de la 1	Utilizați `Pages[1]` pentru prima pagină

Problem	Cause	Solution
Adnotarea nu este vizibilă după salvare	Dreptunghiul are suprafață zero sau este în afara limitelor paginii	Verificați ca coordonatele să cadă în interiorul paginii `MediaBox`
`LinkAnnotation.Uri` returnează null	Link-ul folosește o acțiune GoTo sau JavaScript	Rezolvați prin `PdfAction.Create` și verificați `ActionType`
`Flatten()` aruncă	Adnotarea lipsește referința `/P` (pagină)	Asigurați-vă că adnotarea a fost adăugată prin `Page.Annotations`

Problem	Cause	Solution
Textul extras este distorsionat	Codare non-standard sau mapare de font CID	Verificați încorporarea fonturilor; PDF-urile scanate pot necesita OCR
Nu s-au găsit fragmente de text	Conținutul paginii este o imagine raster	Utilizați OCR înainte de extragerea textului
Expresia regulată nu returnează potriviri	Aspectul textului PDF introduce spații albe	Utilizați un model mai permisiv sau normalizați spațiile albe

Problemă	Cauză	Soluție
Imaginea redată este neclară	Rezoluție prea mică	Crește DPI în constructorul `Resolution`
Ieșirea HTML lipsește imagini	Căile externe ale imaginilor nu sunt configurate	Folosește `HtmlSaveOptions` cu imagini încorporate
Conversia PDF/A elimină adnotările	Profilul țintă nu permite adnotări	Folosește PDF/A-2 sau PDF/A-3

Problemă	Cauză	Soluție
Valoarea câmpului este goală	Câmpul nu are intrare `/V`	Verificați că `field.Value` nu este nul
`FillField` nu are efect	Nume de câmp nepotrivit	Utilizați `Form.FieldNames` pentru a lista numele disponibile
ExportToJson produce ieșire goală	Anotarea widget nu este convertită corect	Verificați că anotarea este un `WidgetAnnotation`

Întotdeauna înfășurați Document în using pentru a elibera handle‑urile de fișiere.
Utilizați Document.Open(byte[]) pentru fluxuri de lucru în memorie pentru a evita blocările de fișiere.
Verificați doc.Pages.Count înainte de a accesa paginile prin index.
Salvați documentul o singură dată după toate modificările pentru cea mai bună performanță.

Depanare

Vezi și