Αντιμετώπιση προβλημάτων

Διάγνωση κοινών σφαλμάτων

Κάθε μήνυμα παρακάτω είναι το κυριολεκτικό κείμενο που παράγει το Doconut, οργανωμένο ανά σύμπτωμα. Βρείτε το σφάλμα σας, εφαρμόστε τη διόρθωση.

Ο προβολέας δεν εμφανίζει τίποτα

Κενή περιοχή προβολέα, η κονσόλα του προγράμματος περιήγησης γεμάτη 404 για /doconut-res/...
UseDoconutResources() λείπει ή τοποθετήθηκε μετά το UseDoconut(). Πρέπει να είναι το πρώτο στη σειρά επεξεργασίας.

HTTP 500 με:

text
Session middleware not configured. Call UseSession() before UseDoconut().

Μια εικόνα σφάλματος στην περιοχή της σελίδας με κείμενο:

text
You Are Not Authorized To View This Page.

Το διακριτικό άνοιξε από διαφορετική συνεδρία προγράμματος περιήγησης. Τυπικές αιτίες: το cookie της συνεδρίας δεν φτάνει στα αιτήματα της σελίδας (ρύθμιση cross‑origin, πολιτική SameSite, πελάτης API χωρίς cookie jar), ή η εφαρμογή επανεκκίνησε (νέα κλειδιά συνεδρίας). Αυτό είναι το επίπεδο ασφαλείας που λειτουργεί όπως σχεδιάστηκε — δείτε τις Βασικές Έννοιες → Συνεδρίες & Ασφάλεια.

Μια εικόνα σφάλματος με κείμενο:

text
Document session not found. Please re-open document.

Το διακριτικό έληξε (παράθυρο ολίσθησης, προεπιλογή 60 λεπτά — DocOptions.TimeOut) ή η συνεδρία έκλεισε. Ανοίξτε ξανά το έγγραφο για ένα νέο διακριτικό.

Η έναρξη ενός εγγράφου αποτυγχάνει

LicenseException με μήνυμα απόρριψης — το αρχείο άδειας βρέθηκε αλλά απορρίφθηκε (μη έγκυρη υπογραφή, παραποιημένο, στη λίστα μαύρων, ή έκδοση εκτός του παραθύρου έκδοσης/ενημέρωσης της άδειας). Αυτή η κατάσταση εμποδίζει το άνοιγμα (fail‑fast) αντί να υποβαθμίζεται σε υδατογράφημα· διαβάστε το License.RejectionMessage για τον λόγο.

LicenseException:

text
This document type requires the 'Dicom' plugin license.

Η επέκταση διαχειρίζεται μόνο από ένα πρόσθετο (εδώ: DICOM) και η δυνατότητα δεν χορηγείται πλέον. Καταχωρίστε το πρόσθετο και επαληθεύστε το lic.IsCapabilityGranted(LicenseCapability.Dicom). Ένα ελλιπές ή ανεπαρκές μη‑προσωρινό δικαίωμα συνήθως αποτυγχάνει νωρίτερα κατά το AddDoconut().

FormatNotSupportedException:

text
Document format '<extension>' is not supported.

Κανένας προβολέας — ενσωματωμένος, πρόσθετο ή προσαρμοσμένος — δεν υποστηρίζει αυτήν την επέκταση. Ελέγξτε τη λίστα υποστηριζόμενων μορφών· για τις δικές σας μορφές, το DoconutOptions.RegisterViewer μπορεί να προσθέσει μία.

InvalidDataException — το περιεχόμενο του αρχείου είναι κατεστραμμένο ή δεν ταιριάζει με την επέκτασή του (π.χ. ένα μετονομασμένο αρχείο). Επικυρώστε τις μεταφορτώσεις πριν το άνοιγμα.

InvalidOperationException:

text
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().

Αντιμετωπίσατε το DocumentConverter χωρίς να έχετε καταχωρίσει το πρόσθετο Converter.

Η εκκίνηση αποτυγχάνει

InvalidOperationException που αναφέρει ένα πρόσθετο καταχωρημένο μέσω AddPlugin — η τρέχουσα μη‑προσωρινή άδεια δεν χορηγεί αυτήν τη δυνατότητα πρόσθετου. Αφαιρέστε την καταχώριση ή εγκαταστήστε μια άδεια που το παρέχει. Ένα ελλιπές αρχείο άδειας και ένα παλιό αρχείο TRIAL δεν παρέχουν δυνατότητες πρόσθετων.

ArgumentException από το AddDoconut():

text
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.

Αποτυχία επικύρωσης επιλογών (fail‑fast) — διορθώστε τη λανθασμένη διαδρομή.

Σφάλματα κατασκευής / εξαρτήσεων

Σφάλμα μεταγλώττισης CS1705, ή κατά το χρόνο εκτέλεσης όταν ανοίγετε ένα έγγραφο:

text
Could not load file or assembly 'System.Text.Json, Version=10.0.0.0'

Το έργο σας καθόρισε σταθερά το System.Text.Json / System.Text.Encodings.Web σε έκδοση κάτω από 10.0.x. Αφαιρέστε την υποβάθμιση και αφήστε το NuGet να επαναφέρει τις εκδόσεις που δηλώνει το Doconut.NET8.

TypeInitializationException στο πρώτο αρχείο παρουσίασης:

text
Could not load ... System.Drawing.Common, Version=6.0.0.0

Η μηχανή παρουσίασης απαιτεί αυστηρά το System.Drawing.Common 6.0.0 (δηλωμένο από το πακέτο). Μην αφαιρέσετε ή παρακάμψετε αυτήν την εξάρτηση — κάθε άνοιγμα PPT/PPTX/PPS/POT/ODP αποτυγχάνει χωρίς αυτήν.

Η έξοδος φαίνεται λανθασμένη

Οι σελίδες εμφανίζουν υδατογράφημα — η εφαρμογή βρίσκεται σε κατάσταση αξιολόγησης: δεν βρέθηκε αρχείο άδειας, έχει λήξει η προσωρινή ή η συνδρομητική περίοδος, ή ο τομέας είναι μη έγκυρος. Εξετάστε το IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, IsValidForDomain, License.RejectionMessage) — η σελίδα Αδειοδότησης δείχνει ένα έτοιμο endpoint.

Τα παλαιά έγγραφα εμφανίζουν παραμορφωμένο κείμενο — οι κωδικοποιήσεις κωδικοσελίδων δεν φορτώνονται εξ ορισμού στο .NET 8. Προσθέστε μία φορά κατά την εκκίνηση:

csharp
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Λάθος ή αντικατεστημένες γραμματοσειρές σε Linux/Docker — το κοντέινερ δεν διαθέτει τις γραμματοσειρές του εγγράφου. Κατευθύνετε το FontFolders (στο WordConfig/PptConfig) σε έναν προσαρτημένο φάκελο γραμματοσειρών.

Οι παρουσιάσεις ανοίγουν αλλά αποτυγχάνουν να αποδοθούν σε Linux/macOS — ο τρέχων renderer PPT/PPTX/PPS/POT/ODP απαιτεί το εγγενές libgdiplus συν System.Drawing.EnableUnixSupport=true. Το πακέτο παρέχει το System.Drawing.Common 6.0.0 επειδή αυτή είναι η τελευταία έκδοση που σέβεται αυτή τη ρύθμιση.

Η λειτουργία λειτουργούσε στην αξιολόγηση, αλλά είναι σιωπηλή στην παραγωγή

Η κλασική έκπληξη κατά την έναρξη: μια ενεργή Temporary άδεια χορηγεί κάθε δυνατότητα· η αγορασμένη άδεια χορηγεί μόνο ό,τι αγοράσατε. Τα πακέτα αναζήτησης και σχολιασμού μπορούν να εξαφανιστούν όταν λείπουν οι δυνατότητές τους. Τα καταχωρημένα πρόσθετα Converter ή DICOM με ανεπαρκή μη‑προσωρινή άδεια αποτυγχάνουν κατά το 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 μετά την αρχικοποίηση — η επιλεγμένη μορφή δεν έχει τυπική διαδρομή αναζήτησης. Αυτό το αποτέλεσμα είναι ξεχωριστό από την άδεια Search· ελέγξτε και τα δύο.

Ακόμα κολλάτε;

Απομονώστε το πρόβλημα με την ελάχιστη εφαρμογή Quick Start· αν επαναληφθεί εκεί, επικοινωνήστε με την υποστήριξη παρέχοντας το έγγραφο, το Program.cs σας και την έξοδο διαγνωστικών της άδειας.

Ήταν αυτή η σελίδα χρήσιμη;