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

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

Πολλές αποτυχίες του 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Ο χειριστής είναι καταχωρημένος χωρίς το ρήμα HEADverb="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 — ένα deadlockAsync="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 χωρίς την άδειά του:

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

Μη έγκυρες επιλογές:

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.

Μια συναρμολόγηση που δεν μπορεί να φορτωθεί.

Το ASP.NET φορτώνει κάθε συναρμολόγηση στο bin\ όταν ξεκινά η εφαρμογή, έτσι μια ανακατεύθυνση binding στο Web.config που ονομάζει μια έκδοση που λείπει από το bin\ σταματά ολόκληρο τον ιστότοπο. Αντιγράψτε τις ανακατευθύνσεις που δημιούργησε το NuGet (για έργο τύπου SDK, από το bin\<YourApp>.dll.config) αντί να τις επεξεργαστείτε χειροκίνητα, και αντιγράψτε τις ξανά μετά τις ενημερώσεις πακέτων.

Δεν Είστε Εξουσιοδοτημένοι Να Προβάλετε Αυτή τη Σελίδα.

Η σελίδα απορρίπτεται επειδή η αιτούσα συνεδρία ASP.NET δεν έλαβε ποτέ το έγγραφο. Ελέγξτε, με τη σειρά:

  1. Η εκκίνηση έτρεχε με κατάσταση συνεδρίας. Οι ελεγκτές MVC και οι σελίδες Web Forms τη διαθέτουν. Ένα προσαρμοσμένο IHttpHandler που ανοίγει έγγραφα πρέπει να υλοποιεί System.Web.SessionState.IRequiresSessionState, αλλιώς δεν έχει συνεδρία να χορηγήσει.
  2. Η κατάσταση συνεδρίας είναι ενεργή. <sessionState mode="Off" /> απορρίπτει κάθε σελίδα.
  3. Το cookie φτάνει στον χειριστή. Τα αιτήματα ίδιας προέλευσης του widget μεταφέρουν ASP.NET_SessionId· ένα script, κλήση server-to-server ή μια cross-origin σελίδα χωρίς cookies δεν το κάνει.
  4. Web farm: η εκκίνηση συνδέει το πρόγραμμα περιήγησης (DocOptions.BrowserId) και η σελίδα περνά το εισιτήριο (objViewer.View(token, access))· κάθε κόμβος χρησιμοποιεί το ίδιο κλειδί υπογραφής.

Η απόρριψη είναι μια εικόνα που σερβίρεται με κατάσταση 200, περίπου 2 KB. Ένας παρατηρητής που ελέγχει μόνο κωδικούς κατάστασης την μετρά ως σελίδα.

Δεν Βρέθηκε Συνεδρία Εγγράφου. Παρακαλώ Ανοίξτε Ξανά το Έγγραφο.

Το διακριτικό έληξε (παράθυρο κύλισης, DocOptions.TimeOut, προεπιλογή 60 λεπτά), το έγγραφο έκλεισε, ή — σε έναν μοναδικό διακομιστή — η δεξαμενή εφαρμογών ανακυκλώθηκε. Η ανακύκλωση συμβαίνει σύμφωνα με το πρόγραμμα, σε κάθε επεξεργασία Web.config, και μετά το λήσιμο αδράνειας της δεξαμενής (20 λεπτά προεπιλογή στο IIS). Ανοίξτε ξανά το έγγραφο για νέο διακριτικό.

Η Άνοιγμα Εγγράφου Αποτυγχάνει

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

LicenseException:

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

Η επέκταση διαχειρίζεται μόνο από ένα πρόσθετο (εδώ DICOM). Το πρόσθετο είναι καταχωρημένο, αλλά καμία άδεια δεν χορηγεί πλέον τη δυνατότητά του — συνήθως μια Προσωρινή άδεια που έληξε μετά την έναρξη του ιστότοπου. Εγκαταστήστε μια άδεια που το χορηγεί.

FormatNotSupportedException — κανένας προβολέας (ενσωματωμένος, πρόσθετο ή προσαρμοσμένος) δεν αναγνωρίζει την επέκταση. DoconutOptions.RegisterViewer μπορεί να προσθέσει έναν για τα δικά σας φορμά.

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

InvalidOperationException:

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

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

csharp
// 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 εάν υπάρχει.

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