Aspose.OCR FOSS for .NET — Felsökning
Denna sida listar de fel och begränsningar som mest sannolikt dyker upp när du integrerar Aspose.OCR FOSS för .NET, med den verkliga orsaken bakom var och en.
Undantag som kastas av Recognize()
AsposeOcr.Recognize() validerar sin inmatning innan någon modell körs. Varje kontroll nedan misslyckas i följande ordning:
| Exception | Orsak | Åtgärd |
|---|---|---|
ArgumentNullException | Den OcrInput som skickas till Recognize() är null | Skapa alltid ett OcrInput innan du anropar Recognize() |
NotSupportedException | OcrInput konstruerades med ett InputType som inte var SingleImage eller PDF | Endast InputType.SingleImage och InputType.PDF är giltiga |
FileNotFoundException | En sökväg som lagts till via OcrInput.Add() finns inte på disken | Validera varje sökväg innan du anropar Add() — en saknad fil får hela anropet att misslyckas, inte bara den filen |
Recognition returnerar ingen text
Om RecognitionResult.RecognitionText är tom och RecognitionLinesResult saknar poster, fann detektorn ingen textlinje-region i bilden. Detta är förväntat — inte en bugg — för:
- Bilder utan läsbar text, eller text som är för liten, roterad eller har låg kontrast för att detektorn ska registrera den som en region
- Icke-latinska skript: den inbäddade igenkänningsmodellen täcker endast latinska skript och deras diakritiska tecken
- Bilder där de upptäckta regionerna filtrerades bort under efterbehandling (mycket låga sannolikhetspoäng för text)
Det finns ingen förtroendescore som exponeras för att skilja “nothing detected” från “detected but uncertain” — se Omfattning och begränsningar.
Igenkänning körs men resultaten ser felaktiga ut
- Roterad eller skev text. Det finns ingen automatisk korrigering av skevhet eller rotation. Förrotera källbilden innan du anropar
Recognize(). - Tabell- eller formulärlayouter ser röriga ut. Detektorn returnerar endast axis-aligned line rectangles — den har ingen uppfattning om kolumner, tabeller eller läsordning utöver linjeposition. Att rekonstruera layouten är anroparens ansvar.
- PDF-textpositionen ser förskjuten ut. PDF-sidor renderas alltid internt med 150 DPI; rektangelkordinater i
RecognitionResult.LinesResult.Lineär i den renderade bildens pixelryta, inte i PDF:ens punktutrymme.
Plattforms- och byggproblem
PlatformNotSupportedExceptioneller liknande vid körning på Linux/macOS. Bildbehandling beror påSystem.Drawing.Common, som är Windows-endast på .NET 6 och senare. Detta biblioteks bildbehandlingsväg körs endast på Windows.- Bygg misslyckas vid mål
net9.0/net10.0. Att bygga dessa mål kräver .NET 10 SDK — se Hur man bygger från källkod. - Mixing
InputType.SingleImageandInputType.PDFi enOcrInput. Stöds inte — se Hur man batchbearbetar flera bilder.
