Αντιμετώπιση προβλημάτων
Διάγνωση κοινών σφαλμάτων
Κάθε μήνυμα παρακάτω είναι το κυριολεκτικό κείμενο που παράγει το Doconut, οργανωμένο ανά σύμπτωμα. Βρείτε το σφάλμα σας, εφαρμόστε τη διόρθωση.
Ο προβολέας δεν εμφανίζει τίποτα
Κενή περιοχή προβολέα, η κονσόλα του προγράμματος περιήγησης γεμάτη 404 για /doconut-res/...
UseDoconutResources() λείπει, ή τοποθετείται μετά το UseDoconut(). Πρέπει να είναι πρώτο στην αλυσίδα επεξεργασίας.
Ο προβολέας αναφέρει The viewer handler could not be reached (no response).
Το αίτημα δεν έλαβε ποτέ απάντηση. Μία κοινή αιτία είναι ένα BasePath που ξεκινά με /: το '/doconut' γίνεται //doconut/DocImage.axd, ένα αίτημα σε άλλο διακομιστή. Γράψτε το χωρίς την αρχική κάθετο (BasePath: 'doconut').
Ο προβολέας αναφέρει Please make sure your middleware is configured.
Το σημείο λήξης της σελίδας απάντησε 404: το UseDoconut() δεν είναι προσαρτημένο εκεί που δείχνει το BasePath του πελάτη. Με app.Map("/doconut", branch => branch.UseDoconut()), ο πελάτης χρησιμοποιεί BasePath: 'doconut'.
HTTP 500 με:
Session middleware not configured. Call UseSession() before UseDoconut().Η ασφάλεια διακριτικού του Doconut (ενεργή από προεπιλογή) χρειάζεται κατάσταση συνεδρίας ASP.NET. Προσθέστε builder.Services.AddSession() και app.UseSession() πριν από το κλαδί μεσαρολογίας του Doconut. Η κατάσταση συνεδρίας χρειάζεται επίσης μια κρυφή μνήμη: σε μια ελάχιστη εφαρμογή API προσθέστε builder.Services.AddDistributedMemoryCache(), ή η εφαρμογή σταματά κατά την εκκίνηση με Unable to resolve service for type 'IDistributedCache' (οι εφαρμογές MVC και Razor Pages ήδη καταχωρούν μία).
Μια εικόνα σφάλματος στην περιοχή της σελίδας με κείμενο:
You Are Not Authorized To View This Page.Το διακριτικό άνοιξε από διαφορετική συνεδρία προγράμματος περιήγησης. Τυπικές αιτίες: το cookie συνεδρίας δεν φτάνει στα αιτήματα της σελίδας (ρύθμιση cross-origin, πολιτική SameSite, πελάτης API χωρίς cookie jar), ή η εφαρμογή επανεκκινήθηκε (νέα κλειδιά συνεδρίας). Αυτό είναι το επίπεδο ασφαλείας που λειτουργεί όπως σχεδιάστηκε — δείτε Core Concepts → Sessions & Security. Η άρνηση είναι μια εικόνα που σερβίρεται με κατάσταση 200, έτσι ένας παρακολουθητής που ελέγχει μόνο κωδικούς κατάστασης την μετρά ως σελίδα.
Μια εικόνα σφάλματος με κείμενο:
Document session not found. Please re-open document.Το διακριτικό έληξε (παράθυρο κύλισης, προεπιλογή 60 λεπτά — DocOptions.TimeOut) ή η συνεδρία έκλεισε. Ανοίξτε ξανά το έγγραφο για ένα νέο διακριτικό.
Η έναρξη ενός εγγράφου αποτυγχάνει
LicenseException με μήνυμα απόρριψης — το αρχείο άδειας βρέθηκε αλλά απορρίφθηκε (μη έγκυρη υπογραφή, παραβλασμένο, στην μαύρη λίστα, ή μια έκδοση εκτός του παραθύρου έκδοσης/ενημέρωσης της άδειας). Αυτή η κατάσταση εμποδίζει το άνοιγμα (fail-fast) αντί να υποβαθμίζεται σε υδατογράφημα· διαβάστε License.RejectionMessage για τον λόγο.
LicenseException:
This document type requires the 'Dicom' plugin license.Η επέκταση διαχειρίζεται μόνο από ένα πρόσθετο (εδώ: DICOM). Το πρόσθετο είναι καταχωρημένο, αλλά καμία άδεια δεν χορηγεί πλέον τη δυνατότητά του — συνήθως μια Προσωρινή άδεια που έληξε μετά την εκκίνηση της εφαρμογής. Εγκαταστήστε μια άδεια που το χορηγεί και επαληθεύστε IsCapabilityGranted(LicenseCapability.Dicom) στο IDoconutLicenseService. Μια ελλιπής ή ανεπαρκής μη προσωρινή ενδυνάμωση συνήθως αποτυγχάνει κατά τη διάρκεια του AddDoconut().
FormatNotSupportedException:
Document format '<extension>' is not supported.Κανένας προβολέας — ενσωματωμένος, πρόσθετο ή προσαρμοσμένος — δεν υποστηρίζει αυτήν την επέκταση. Ελέγξτε τη λίστα υποστηριζόμενων μορφών· για τις δικές σας μορφές, το DoconutOptions.RegisterViewer μπορεί να προσθέσει μία.
InvalidDataException — το περιεχόμενο του αρχείου είναι κατεστραμμένο ή δεν ταιριάζει με την επέκτασή του (π.χ. ένα μετονομασμένο αρχείο). Επαληθεύστε τις μεταφορτώσεις πριν το άνοιγμα.
InvalidOperationException:
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().Επιλύσατε το DocumentConverter χωρίς να καταχωρήσετε το πρόσθετο Converter.
Αποτυχία εκκίνησης
InvalidOperationException αναφορά σε πρόσθετο που καταχωρήθηκε μέσω AddPlugin — η τρέχουσα μη-προσωρινή άδεια δεν παρέχει αυτή τη δυνατότητα πρόσθετου. Αφαιρέστε την καταχώρηση ή εγκαταστήστε μια άδεια που την παρέχει. Μια ελλιπής άδεια και ένα παλιό αρχείο TRIAL δεν παρέχουν δυνατότητες πρόσθετου.
ArgumentException από AddDoconut():
DoconutOptions.MiddlewarePath must be a non-empty path starting with '/'.
DoconutOptions.ResourcesPath must be a non-empty path starting with '/'.
DoconutOptions.MiddlewarePath and ResourcesPath must be different paths.Σφάλματα κατασκευής / εξαρτήσεων
Σφάλμα μεταγλωττιστή CS1705, ή κατά την εκτέλεση όταν ανοίγετε ένα έγγραφο:
Could not load file or assembly 'System.Text.Json, Version=8.0.0.0'Το έργο σας καθόρισε System.Text.Json ή System.Text.Encodings.Web κάτω από τις εξαρτήσεις 8.0.x που δηλώνονται από Doconut.NET8. Αφαιρέστε την υποβάθμιση και αφήστε το NuGet να επαναφέρει το γράφημα πακέτων (System.Text.Json 8.0.5 και System.Text.Encodings.Web 8.0.0).
Η έξοδος φαίνεται λανθασμένη
Οι σελίδες φέρουν υδατογράφημα — η εφαρμογή βρίσκεται σε κατάσταση αξιολόγησης: δεν βρέθηκε αρχείο άδειας, λήξη προσωρινής άδειας ή μη έγκυρος τομέας. Με ενεργή προσωρινή άδεια, μόνο η έξοδος του πρόσθετου υδατογραφείται. Μια κατασκευή που κυκλοφόρησε μετά την ημερομηνία συνδρομής μιας πληρωμένης άδειας δεν υδατογραφείται: το άνοιγμα προκαλεί LicenseException. Εξετάστε IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, IsValidForDomain, License.RejectionMessage) — η αναφορά IDoconutLicenseService της σελίδας Αδειοδότησης εμφανίζει ένα έτοιμο σημείο λήψης.
Τα παλιά έγγραφα εμφανίζουν παραμορφωμένο κείμενο — οι κωδικοποιήσεις σελίδας κώδικα δεν φορτώνονται εξ ορισμού στο .NET 8. Προσθέστε μία φορά κατά την εκκίνηση:
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);Λάθος ή αντικατεστημένες γραμματοσειρές — ο διακομιστής δεν διαθέτει τις γραμματοσειρές του εγγράφου. Εγκαταστήστε τις ή κατευθύνετε FontFolders (στο WordConfig/PptConfig) σε έναν φάκελο που τις περιέχει. Σε Linux, δείτε παρακάτω.
Μια σημείωση εικόνας εμφανίζεται στον προβολέα αλλά η εξαγωγή έχει ένα πλαίσιο «Image blocked» — ο κεντρικός υπολογιστής της εικόνας έχει ιδιωτική ή διεύθυνση loopback, την οποία ο διακομιστής αρνείται να φέρει. Δείτε Σχόλια.
Linux
Το άνοιγμα οποιουδήποτε εγγράφου αποτυγχάνει με:
The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.Εγκαταστήστε τη βιβλιοθήκη διαμόρφωσης γραμματοσειρών: apt-get install -y libfontconfig1 (fontconfig σε RHEL/Fedora). Δείτε Εγκατάσταση.
Το άνοιγμα οποιουδήποτε εγγράφου αποτυγχάνει με:
The application uses a newer SkiaSharp than Doconut's native graphics library. Add the package SkiaSharp.NativeAssets.Linux at the same version as the application's SkiaSharp; see the Linux section of the Doconut documentation.Η εφαρμογή αναφέρεται σε νεότερο SkiaSharp, άμεσα ή μέσω άλλης βιβλιοθήκης. Προσθέστε SkiaSharp.NativeAssets.Linux στην ίδια έκδοση με αυτό το SkiaSharp.
Το άνοιγμα οποιουδήποτε εγγράφου αποτυγχάνει με:
The native graphics library for this platform was not found next to the application. Doconut supports Windows x64/x86 and glibc-based Linux x64 (Alpine/musl is not supported); see the Linux section of the Doconut documentation.Ο κεντρικός υπολογιστής δεν είναι υποστηριζόμενη πλατφόρμα. Οι διανομές Alpine και άλλες βασισμένες σε musl δεν υποστηρίζονται: χρησιμοποιήστε μια εικόνα βασισμένη σε Debian ή Ubuntu.
Το κείμενο είναι πιο πλατύ ή πιο στενό από τα Windows, ή οι γραμμές σπάζουν διαφορετικά — οι γραμματοσειρές του εγγράφου δεν είναι εγκατεστημένες, έτσι το Doconut χρησιμοποιεί τη πιο κοντινή εγκατεστημένη γραμματοσειρά. Εγκαταστήστε γραμματοσειρές συμβατές με μετρική (fonts-liberation για Arial, Times New Roman και Courier New· fonts-crosextra-carlito και fonts-crosextra-caladea για Calibri και Cambria), ή αντιγράψτε τις δικές σας αδειοδοτημένες γραμματοσειρές στο /usr/share/fonts/ και εκτελέστε fc-cache -f. Το ασιατικό κείμενο που εμφανίζεται ως κενά κουτιά χρειάζεται fonts-noto-cjk.
Η δυνατότητα λειτουργούσε στην αξιολόγηση, σιωπηλή στην παραγωγή
Η κλασική έκπληξη κατά την έναρξη λειτουργίας: μια ενεργή Προσωρινή άδεια παρέχει κάθε δυνατότητα· η αγορασμένη άδειά σας παρέχει μόνο ό,τι αγοράσατε. Τα πακέτα Αναζήτησης και σχολιασμού μπορούν να εξαφανιστούν όταν λείπουν οι δυνατότητές τους. Τα καταχωρημένα Converter ή DICOM plugins με ανεπαρκή μη προσωρινή άδεια αποτυγχάνουν κατά τη διάρκεια του AddDoconut(). Συγκρίνετε το IsCapabilityGranted(...) με κάθε δυνατότητα που ενεργοποιείτε πριν από την ανάπτυξη.
Η Αναζήτηση δεν βρίσκει τίποτα (ή πολύ λίγα)
- Για ένα άμεσο PDF, το
AllowSearchδεν ήταν ενεργοποιημένο κατά το άνοιγμα. Το Word, το Excel και το PowerPoint εκθέτουν την ίδια επιλογή μέσω των ενσωματωμένων τουςPdfConfig. - Το περιεχόμενο είναι σαρωμένο/μόνο εικόνα, έτσι η κανονική Αναζήτηση δεν έχει στρώση κειμένου για αντιστοίχιση. Χρησιμοποιήστε μια πηγή που περιέχει κείμενο ή μια προβολή PDF που διατηρεί το κείμενο.
- Το HTML και το MS Project (MPP) δεν είναι αναζητήσιμα στις προεπιλογές τους — ορίστε το
DefaultRender = falseώστε να αποδίδονται μέσω μιας προβολής PDF με εγγενή στρώση κειμένου. Το Word, το Excel, το PowerPoint, το TXT, το Visio, το email, το EPUB και το MHT αναζητούνται στις προεπιλογές του καταλόγου τους. objViewer.CanSearch()είναιfalseμετά την αρχικοποίηση — η επιλυμένη μορφή δεν έχει τυπική διαδρομή αναζήτησης. Αυτό το αποτέλεσμα είναι ξεχωριστό από την άδεια Αναζήτησης· επαληθεύστε και τα δύο.- Η σελίδα διαβάζει την τιμή επιστροφής του
objViewer.Search(...)— η καταμέτρηση φτάνει στο τρίτο του όρισμα, μια κλήση επιστροφής.
Ακόμα κολλάτε;
Απομονώστε το πρόβλημα χρησιμοποιώντας την ελάχιστη εφαρμογή Quick Start· αν επαναληφθεί εκεί, επικοινωνήστε με την υποστήριξη μαζί με το έγγραφο, το Program.cs σας και την έξοδο διαγνωστικών της άδειας.
Ήταν αυτή η σελίδα χρήσιμη;