Aspose.OCR FOSS for .NET — Fehlerbehebung
Diese Seite listet die Fehler und Einschränkungen auf, die beim Integrieren von Aspose.OCR FOSS für .NET am wahrscheinlichsten auftreten, samt der tatsächlichen Ursache für jeden einzelnen.
Ausnahmen, die von Recognize() geworfen werden
AsposeOcr.Recognize() validiert seine Eingaben, bevor ein Modell ausgeführt wird. Jede der nachfolgenden Prüfungen schlägt in dieser Reihenfolge fehl:
| Exception | Ursache | Behebung |
|---|---|---|
ArgumentNullException | Der OcrInput, der an Recognize() übergeben wurde, ist null | Erstelle immer ein OcrInput bevor du Recognize() aufrufst |
NotSupportedException | OcrInput wurde mit einem InputType konstruiert, das nicht SingleImage oder PDF ist | Nur InputType.SingleImage und InputType.PDF sind gültig |
FileNotFoundException | Ein über OcrInput.Add() hinzugefügter Pfad existiert nicht auf dem Datenträger | Validieren Sie jeden Pfad, bevor Sie Add() aufrufen — eine fehlende Datei lässt den gesamten Aufruf fehlschlagen, nicht nur diese Datei |
Erkennung gibt keinen Text zurück
Wenn RecognitionResult.RecognitionText leer ist und RecognitionLinesResult keine Einträge hat, hat der Detektor keine Textzeilenregion im Bild gefunden. Dies ist zu erwarten — kein Fehler — für:
- Bilder ohne lesbaren Text oder Text, der zu klein, gedreht oder von zu geringem Kontrast ist, damit der Detektor ihn als Region erkennt
- Nicht-lateinische Schriften: Das eingebettete Erkennungsmodell unterstützt nur lateinischen Text und dessen diakritische Zeichen
- Bilder, bei denen die erkannten Regionen während der Nachbearbeitung herausgefiltert wurden (sehr niedrige Textwahrscheinlichkeitswerte)
Es gibt keinen ausgewiesenen Konfidenzwert, um „nichts erkannt“ von „erkannt, aber unsicher“ zu unterscheiden — siehe Umfang und Einschränkungen.
Erkennung läuft, aber Ergebnisse sehen falsch aus
- Gedrehter oder verzerrter Text. Es gibt keine automatische Entzerrung oder Drehkorrektur. Drehen Sie das Quellbild vor dem Aufruf vor.
Recognize(). - Tabellen- oder Formularlayouts sehen durcheinander aus. Der Detektor gibt nur achsenparallel ausgerichtete Linienrechtecke zurück – er kennt keine Spalten, Tabellen oder Lesereihenfolge über die Linienposition hinaus. Das Wiederherstellen des Layouts ist die Verantwortung des Aufrufers.
- Die PDF-Textposition scheint versetzt zu sein. PDF-Seiten werden intern immer mit 150 DPI gerendert; Rechteckkoordinaten in
RecognitionResult.LinesResult.Linebefinden sich im Pixelraum dieses gerenderten Bildes, nicht im Punktesystem des PDFs.
Plattform- und Build-Probleme
PlatformNotSupportedExceptionoder Ähnliches zur Laufzeit unter Linux/macOS. Die Bildverarbeitung hängt ab vonSystem.Drawing.Common, das ab .NET 6 und später nur unter Windows verfügbar ist. Der Bildverarbeitungs-Pfad dieser Bibliothek läuft nur unter Windows.- Build schlägt fehl beim Ziel
net9.0/net10.0. Das Erstellen dieser Ziele erfordert das .NET 10 SDK — siehe Wie man aus dem Quellcode baut. - Mixing
InputType.SingleImageandInputType.PDFin einemOcrInput. Nicht unterstützt — siehe Wie man mehrere Bilder stapelweise verarbeitet.
