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

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

Κάθε μήνυμα παρακάτω είναι το ακριβές κείμενο που παράγει το 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 με:

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

Η ασφάλεια διακριτικού του Doconut (ενεργή από προεπιλογή) απαιτεί κατάσταση συνεδρίας ASP.NET. Προσθέστε builder.Services.AddSession() και app.UseSession() πριν από το κλάδο μεσαρολογίας Doconut. Η κατάσταση συνεδρίας χρειάζεται επίσης μια κρυφή μνήμη: σε μια εφαρμογή minimal-API προσθέστε builder.Services.AddDistributedMemoryCache(), ή η εφαρμογή σταματά κατά την εκκίνηση με Unable to resolve service for type 'IDistributedCache' (οι εφαρμογές MVC και Razor Pages καταχωρούν ήδη μία).

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

text
You Are Not Authorized To View This Page.

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

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

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

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

Ο διακομιστής λειτουργεί σωστά αλλά η σελίδα συμπεριφέρεται λανθασμένα — χωρίς κανένα σφάλμα

Αυτές είναι οι μορφές αποτυχίας που πρέπει να υποψιάζεστε πρώτα μετά τη μεταφορά μιας εφαρμογής. Όλες
τρείς αφήνουν τον διακομιστή να λειτουργεί τέλεια, αποδίδουν το έγγραφο σωστά και δεν αναφέρουν τίποτα στην κονσόλα του προγράμματος περιήγησης.

Ένας ενεργός δείκτης φόρτωσης που δεν σταματά ποτέ. Οι κλήσεις επιστροφής του προβολέα σας δηλώνονται ως παγκόσμιες συναρτήσεις με όνομα το αναγνωριστικό του container — ctlDoc_OnViewerReady() και φίλοι. Ο προηγούμενος προβολέας έψαχνε αυτά τα ονόματα· αυτός δεν το κάνει. Ο χειριστής που θα έσβενε τον δείκτη φόρτωσης απλώς δεν εκτελείται ποτέ. Περνάτε τις συναρτήσεις ως επιλογές αντί αυτού:

javascript
function ctlDoc_OnViewerBusy() { /* εμφανίστε τον δείκτη απασχόλησής σας */ }
function ctlDoc_OnViewerReady() { /* αποκρύψτε το */ }
function ctlDoc_Copy(text) { /* χρησιμοποιήστε το αντιγραμμένο κείμενο */ }
function ctlDoc_AutoLoadStatus(pageNum) { /* αναφέρετε την πρόοδο */ }

const objViewer = $('#div_ctlDoc').docViewer({
    // ... τις υπάρχουσες επιλογές σας ...
    onViewerBusy:     ctlDoc_OnViewerBusy,
    onViewerReady:    ctlDoc_OnViewerReady,
    onCopy:           ctlDoc_Copy,
    onAutoLoadStatus: ctlDoc_AutoLoadStatus
});

Το έγγραφο πίσω από τον δείκτη φόρτωσης είναι εντάξει. Η πλήρης λίστα επιλογών βρίσκεται στο Διαμόρφωση Προβολέα.

Λείπουν εικονίδια προβολέα ή chrome, οι σελίδες είναι διαφορετικά σωστές. ResPath είναι κενό ή δείχνει στη ρίζα της εφαρμογής — σωστό στη προηγούμενη βιβλιοθήκη, λάθος εδώ. Πρέπει να ονομάζει το πρόθεμα που το UseDoconutResources() προσαρτά:

javascript
ResPath: 'doconut-res/images'   // ή '<your ResourcesPath>/images'

Κατεστραμμένα πλακίδια για μεταγενέστερες σελίδες όταν εξυπηρετούνται από κοινόχρηστη αποθήκη. Οι σελίδες που εξακολουθούν να γράφονται απαντούν 202 Accepted. Ένας πελάτης χωρίς retryOn409: true το θεωρεί ως αποτυχημένη εικόνα. Δείτε τις Κατανεμημένες Αναπτύξεις.

Αποτυχία ανοίγματος εγγράφου

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

LicenseException:

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

Η επέκταση διαχειρίζεται μόνο από ένα πρόσθετο (εδώ: DICOM). Το πρόσθετο είναι καταχωρημένο, αλλά καμία άδεια δεν χορηγεί πλέον τη δυνατότητά του — συνήθως μια Προσωρινή άδεια που έληξε μετά την εκκίνηση της εφαρμογής. Εγκαταστήστε μια άδεια που το χορηγεί και επαληθεύστε IsCapabilityGranted(LicenseCapability.Dicom) στο IDoconutLicenseService. Ένα ελλιπές ή ανεπαρκές μη‑προσωρινό δικαίωμα συνήθως αποτυγχάνει νωρίτερα, κατά τη διάρκεια του 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.

Επικύρωση επιλογών άμεσης αποτυχίας — διορθώστε τη λανθασμένη διαδρομή.

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

Το πακέτο δεν θα εγκατασταθεί καθόλου — Doconut.NETStandard στοχεύει netstandard2.1, έτσι το NuGet απορρίπτει ένα έργο .NET Framework. Αυτό δεν είναι ένα επιλύσιμο σφάλμα επαναφοράς: το .NET Framework δεν μπορεί να καταναλώσει netstandard2.1. Χρησιμοποιήστε το πακέτο Doconut.NETFramework αντ' αυτού.

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

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

Το έργο σας έχει κλειδώσει το System.Text.Json ή το System.Text.Encodings.Web κάτω από τις εξαρτήσεις 9.0.x που δηλώνονται από το Doconut.NETStandard. Αφαιρέστε την υποβάθμιση και αφήστε το NuGet να επαναφέρει το γράφημα πακέτων (System.Text.Json 9.0.0 και System.Text.Encodings.Web 9.0.0 όπως δηλώνεται από το πακέτο).

Ένας τοίχος από σφάλματα μεταγλώττισης αμέσως μετά την αναβάθμιση του πακέτου — αυτό είναι αναμενόμενο. Το 26.8.0 είναι διαφορετική επιφάνεια API από το 26.7.0, δεν είναι μια συμβατή ενημέρωση. Τα περισσότερα σφάλματα είναι οι γραμμές using που μεταφέρθηκαν στο ριζικό χώρο ονομάτων Doconut· δουλέψτε μέσω του Μετάβαση σε .NET Standard 2.1 αντί να τα διορθώνετε ένα‑ένα.

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

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

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

Το αποτέλεσμα φαίνεται λανθασμένο

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

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

csharp
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

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

Μια σημείωση εικόνας εμφανίζεται στον προβολέα αλλά η εξαγωγή έχει ένα πλαίσιο «Image blocked» — ο κεντρικός υπολογιστής της εικόνας έχει ιδιωτική ή διεύθυνση loopback, την οποία ο διακομιστής αρνείται να ανακτήσει. Δείτε τις Σχόλια.

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

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

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

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

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