Αντιμετώπιση προβλημάτων
Διάγνωση κοινών σφαλμάτων
Πολλές αποτυχίες του System.Web δεν εγείρουν εξαίρεση που μπορείτε να δείτε: η σελίδα απαντά με ένα κενό 500, ένα εικονίδιο 404 ή ένα αίτημα δεν επιστρέφει ποτέ. Αυτή η σελίδα είναι οργανωμένη με βάση ό,τι παρατηρείτε. Τα παρατιθέμενα μηνύματα είναι το κυριολεκτικό κείμενο που παράγει το Doconut.
Συμπτώματα με μια ματιά
| Τι βλέπετε | Πιθανότερη αιτία | Διόρθωση |
|---|---|---|
Κάθε αίτημα απαντά με ένα κενό 500 | Μια εξαίρεση στο Application_Start: ένα plugin χωρίς την άδειά του, μια μη έγκυρη επιλογή, μια ελλιπής διαμόρφωση farm — ή μια ανακατεύθυνση binding που ονομάζει μια έκδοση που δεν υπάρχει στο bin\ | Καταγραφή συμβάντων των Windows, Εφαρμογή, πηγή ASP.NET. Δείτε Αποτυχίες εκκίνησης |
Μερικές σελίδες MVC απαντούν με ένα κενό 500 | Το Razor μεταγλωττίζει τις προβολές κατά το χρόνο εκτέλεσης: η προσκηνή netstandard λείπει από το <compilation>, ή η προβολή χρησιμοποιεί C# νεότερο από 5 (?., $"...", nameof) | Προσθέστε την προσκηνή (Εγκατάσταση); μετακινήστε τη λογική από την προβολή στον ελεγκτή |
Οι σελίδες εμφανίζουν —, … ή παρόμοια αντί για παύλες και τόνους | Αρχεία σελίδας χωρίς byte-order mark διαβάζονται με τη σελίδα κώδικα ANSI του διακομιστή | <globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8" /> |
Η κονσόλα του προγράμματος περιήγησης εμφανίζει 404 για HEAD /DocImage.axd?...&page=1 | Ο χειριστής είναι καταχωρημένος χωρίς το ρήμα HEAD | verb="GET,HEAD,POST" στον χειριστή |
| Το έγγραφο αποδίδεται, αλλά τα εικονίδια της γραμμής εργαλείων και ο δείκτης φόρτωσης λείπουν | ResPath δείχνει στη ρίζα του πόρου, ή ξεκινά με / | ResPath: 'doconut-res/images' |
Αιτήματα /doconut-res/... απαντούν 404 | Το module πόρων δεν είναι καταχωρημένο, το runAllManagedModulesForAllRequests είναι απενεργοποιημένο, ή η δρομολόγηση MVC παγιδεύει τη διαδρομή | Η καταχώρηση <modules>, και routes.IgnoreRoute("doconut-res/{*pathInfo}") |
Ο προβολέας αναφέρει The viewer handler could not be reached (no response). | BasePath ξεκινά με / ('/myapp' γίνεται //myapp/…, άλλο κεντρικό σύστημα) | BasePath: '/' στη ρίζα του ιστότοπου· 'myapp' σε εικονικό κατάλογο |
Ο προβολέας αναφέρει Please make sure your middleware is configured. | DocImage.axd απάντησε 404: ο χειριστής δεν βρίσκεται στο Web.config, η δρομολόγηση MVC το παγίδεψε, ή το BasePath δείχνει αλλού | Η καταχώρηση <handlers>, routes.IgnoreRoute("{resource}.axd/{*pathInfo}"), και BasePath |
Κάθε σελίδα εμφανίζει You Are Not Authorized To View This Page. | Το έγγραφο άνοιξε σε αίτημα χωρίς κατάσταση συνεδρίας, η κατάσταση συνεδρίας είναι απενεργοποιημένη, ή το cookie συνεδρίας δεν φτάνει στο DocImage.axd | Δείτε Μη εξουσιοδοτημένο |
| Μια μετατροπή Web Forms δεν επιστρέφει ποτέ | Η σελίδα μπλοκάρει στο ConvertAsync — ένα deadlock | Async="true" + RegisterAsyncTask (Πρόσθετο Μετατροπέα) |
| Κάθε σελίδα φέρει υδατογράφημα αξιολόγησης | Δεν βρέθηκε άδεια — δεν βρίσκεται στο <site root>\wwwroot | Ρύθμιση Άδειας |
Ένα widget φορτώνει, αλλά η πρώτη του ενέργεια απαντά 404 | Το widget δεν είναι ενεργοποιημένο, ή το basePath του δεν είναι '/DocImage.axd' | options.Add…Widget(), και basePath: '/DocImage.axd' |
| Το πρώτο έγγραφο μετά την εκκίνηση ή την επανεκκίνηση του ιστότοπου παίρνει ένα λεπτό ή περισσότερο· τα επόμενα είναι γρήγορα | Οι μηχανές εγγράφων φορτώνουν στην πρώτη άνοιξη, και το antivirus σε πραγματικό χρόνο τις σαρώσει καθώς φορτώνουν | Ζεστάνετε τον ιστότοπο και κρατήστε την πισίνα ενεργή — δείτε Το πρώτο έγγραφο μετά την εκκίνηση |
| Μια μεγάλη μεταφόρτωση εμφανίζει σελίδα σφάλματος IIS | Η μεταφόρτωση υπερβαίνει το maxRequestLength (KB) ή το maxAllowedContentLength (bytes) | Αυξήστε και τα δύο πάνω από το μεγαλύτερο αρχείο ή το όριο widget |
Αποτυχίες εκκίνησης
Μια εξαίρεση που ρίχνεται στο Application_Start δεν φτάνει στο πρόγραμμα περιήγησης: κάθε αίτημα απαντά με ένα κενό 500, και το αρχείο καταγραφής IIS δεν εμφανίζει κάτι χρήσιμο. Η εξαίρεση βρίσκεται στο Windows event log (Event Viewer → Windows Logs → Application, source ASP.NET). Τα συνηθισμένα:
Ένα plugin χωρίς την άδειά του:
The Converter plugin is registered via AddPlugin but no active license grants Converter.
Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.Το Doconut.Viewer.<Capability>.lic του plugin πρέπει να βρίσκεται στο wwwroot, δίπλα στο Doconut.Viewer.lic. Μια ελλιπής άδεια και ένα παλιό αρχείο TRIAL δεν παρέχουν δυνατότητες plugin.
Μη έγκυρες επιλογές:
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.Μια συναρμολόγηση που δεν μπορεί να φορτωθεί.
Το ASP.NET φορτώνει κάθε συναρμολόγηση στο bin\ όταν ξεκινά η εφαρμογή, έτσι μια ανακατεύθυνση binding στο Web.config που ονομάζει μια έκδοση που λείπει από το bin\ σταματά ολόκληρο τον ιστότοπο. Αντιγράψτε τις ανακατευθύνσεις που δημιούργησε το NuGet (για έργο τύπου SDK, από το bin\<YourApp>.dll.config) αντί να τις επεξεργαστείτε χειροκίνητα, και αντιγράψτε τις ξανά μετά τις ενημερώσεις πακέτων.
Δεν Είστε Εξουσιοδοτημένοι Να Προβάλετε Αυτή τη Σελίδα.
Η σελίδα απορρίπτεται επειδή η αιτούσα συνεδρία ASP.NET δεν έλαβε ποτέ το έγγραφο. Ελέγξτε, με τη σειρά:
- Η εκκίνηση έτρεχε με κατάσταση συνεδρίας. Οι ελεγκτές MVC και οι σελίδες Web Forms τη διαθέτουν. Ένα προσαρμοσμένο
IHttpHandlerπου ανοίγει έγγραφα πρέπει να υλοποιείSystem.Web.SessionState.IRequiresSessionState, αλλιώς δεν έχει συνεδρία να χορηγήσει. - Η κατάσταση συνεδρίας είναι ενεργή.
<sessionState mode="Off" />απορρίπτει κάθε σελίδα. - Το cookie φτάνει στον χειριστή. Τα αιτήματα ίδιας προέλευσης του widget μεταφέρουν
ASP.NET_SessionId· ένα script, κλήση server-to-server ή μια cross-origin σελίδα χωρίς cookies δεν το κάνει. - Web farm: η εκκίνηση συνδέει το πρόγραμμα περιήγησης (
DocOptions.BrowserId) και η σελίδα περνά το εισιτήριο (objViewer.View(token, access))· κάθε κόμβος χρησιμοποιεί το ίδιο κλειδί υπογραφής.
Η απόρριψη είναι μια εικόνα που σερβίρεται με κατάσταση 200, περίπου 2 KB. Ένας παρατηρητής που ελέγχει μόνο κωδικούς κατάστασης την μετρά ως σελίδα.
Δεν Βρέθηκε Συνεδρία Εγγράφου. Παρακαλώ Ανοίξτε Ξανά το Έγγραφο.
Το διακριτικό έληξε (παράθυρο κύλισης, DocOptions.TimeOut, προεπιλογή 60 λεπτά), το έγγραφο έκλεισε, ή — σε έναν μοναδικό διακομιστή — η δεξαμενή εφαρμογών ανακυκλώθηκε. Η ανακύκλωση συμβαίνει σύμφωνα με το πρόγραμμα, σε κάθε επεξεργασία Web.config, και μετά το λήσιμο αδράνειας της δεξαμενής (20 λεπτά προεπιλογή στο IIS). Ανοίξτε ξανά το έγγραφο για νέο διακριτικό.
Η Άνοιγμα Εγγράφου Αποτυγχάνει
LicenseException με λόγο απόρριψης — το αρχείο άδειας βρέθηκε αλλά απορρίφθηκε (μη έγκυρη υπογραφή, παραποίηση, μαύρη λίστα, ή έκδοση εκτός του παραθύρου έκδοσης της άδειας). Το άνοιγμα αποκλείεται αντί να υδατογραφήσει.
LicenseException:
This document type requires the 'Dicom' plugin license.Η επέκταση διαχειρίζεται μόνο από ένα πρόσθετο (εδώ DICOM). Το πρόσθετο είναι καταχωρημένο, αλλά καμία άδεια δεν χορηγεί πλέον τη δυνατότητά του — συνήθως μια Προσωρινή άδεια που έληξε μετά την έναρξη του ιστότοπου. Εγκαταστήστε μια άδεια που το χορηγεί.
FormatNotSupportedException — κανένας προβολέας (ενσωματωμένος, πρόσθετο ή προσαρμοσμένος) δεν αναγνωρίζει την επέκταση. DoconutOptions.RegisterViewer μπορεί να προσθέσει έναν για τα δικά σας φορμά.
InvalidDataException — το περιεχόμενο είναι κατεστραμμένο ή δεν ταιριάζει με την επέκταση (αρχείο με αλλαγμένο όνομα). Επικυρώστε τις μεταφορτώσεις πριν το άνοιγμα.
InvalidOperationException:
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().DocumentConverter επιλύθηκε χωρίς την καταχώρηση του πρόσθετου Converter.
Η Έξοδος Φαίνεται Λάθος
Οι σελίδες φέρουν υδατογράφημα — δεν βρέθηκε άδεια, ή η Προσωρινή άδεια έχει λήξει. Με ενεργή Προσωρινή άδεια, μόνο η έξοδος του πρόσθετου υδατογραφείται. Μια άδεια που δεν καλύπτει αυτήν την έκδοση δεν υδατογραφείται: το άνοιγμα ρίχνει LicenseException. Στο IIS, η άδεια πρέπει να βρίσκεται στο wwwroot κάτω από τη ρίζα του site (AppContext.BaseDirectory\wwwroot), όχι στο bin\. Ελέγξτε το IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, License.RejectionMessage).
Τα παλαιά έγγραφα εμφανίζουν ακατάληπτο κείμενο — καταχωρήστε τις κωδικοποιήσεις κωδικής σελίδας μία φορά, κατά την εκκίνηση:
// Global.asax.cs, Application_Start - πριν DoconutHost.Initialize.
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);Λάθος ή αντικατεστημένες γραμματοσειρές — ο διακομιστής δεν διαθέτει τις γραμματοσειρές του εγγράφου. Ένας Windows Server χωρίς Office έχει πολύ λιγότερες γραμματοσειρές από ένα μηχάνημα ανάπτυξης. Εγκαταστήστε τις γραμματοσειρές, ή κατευθύνετε το FontFolders (σε WordConfig και PptConfig) σε έναν φάκελο που τις περιέχει.
Μια σημείωση εικόνας εμφανίζεται στον προβολέα αλλά η εξαγωγή έχει ένα πλαίσιο «Image blocked» — ο κεντρικός υπολογιστής της εικόνας έχει ιδιωτική ή διεύθυνση loopback, την οποία ο διακομιστής αρνείται να φέρει. Δείτε Σχόλια.
Η Λειτουργία Λειτούργησε στην Αξιολόγηση, Σιωπηλή στην Παραγωγή
Μια ενεργή Προσωρινή άδεια χορηγεί κάθε δυνατότητα· η αγορασμένη άδεια χορηγεί μόνο ό,τι αγοράσατε. Χωρίς δυνατότητα, τα αρχεία Αναζήτησης ή Σχόλια δεν εκδίδονται, και ένα καταχωρημένο πρόσθετο σταματά το site κατά την εκκίνηση. Συγκρίνετε το IsCapabilityGranted(...) με κάθε λειτουργία που χρησιμοποιείτε πριν την ανάπτυξη.
Η αναζήτηση δεν βρίσκει τίποτα (ή πολύ λίγα)
- Για ένα PDF, το
AllowSearchδεν ήταν ενεργοποιημένο όταν το έγγραφο ανοίχτηκε — η προεπιλογή είναιfalse. Το Word, το Excel και το PowerPoint εκθέτουν τον ίδιο διακόπτη. - Το περιεχόμενο είναι σαρωμένο ή μόνο εικόνα, επομένως δεν υπάρχει στρώση κειμένου για αντιστοίχιση.
- Το HTML και το Microsoft Project (MPP) δεν είναι αναζητήσιμα στις προεπιλογές τους: ορίστε το
DefaultRender = falseώστε να αποδίδονται μέσω μιας προβολής PDF με κείμενο. - Το
objViewer.CanSearch()είναιfalseμετά την εκκίνηση: η επιλυμένη μορφή δεν έχει διαδρομή αναζήτησης. Αυτό είναι ξεχωριστό από την άδεια Search· ελέγξτε και τα δύο. - Η σελίδα διαβάζει την τιμή επιστροφής του
objViewer.Search(...)— η καταμέτρηση φτάνει στο τρίτο του όρισμα, μια κλήση επιστροφής.
Ακόμα κολλάτε;
Αναπαράγετε το πρόβλημα με τη ελάχιστη ρύθμιση από το Γρήγορη Εκκίνηση. Αν εμφανιστεί εκεί, επικοινωνήστε με την υποστήριξη μαζί με το έγγραφο, το Global.asax.cs, τα τμήματα Doconut του Web.config, και την καταχώρηση του Windows event log εάν υπάρχει.
Ήταν αυτή η σελίδα χρήσιμη;