Řešení problémů
Diagnostika běžných chyb
Mnoho selhání System.Web nevyvolá žádnou výjimku, kterou byste viděli: stránka vrací prázdný 500, ikona vrací 404, nebo požadavek se nikdy nevrátí. Tato stránka je uspořádána podle toho, co pozorujete. Citované zprávy jsou doslovný text, který Doconut vytváří.
Symptomy na první pohled
| Co vidíte | Nejpravděpodobnější příčina | Oprava |
|---|---|---|
Každý požadavek vrací prázdný 500 | Výjimka v Application_Start: plugin bez licence, neplatná volba, neúplná konfigurace farmy — nebo přesměrování vazby pojmenovávající verzi, která není v bin\ | Protokol událostí Windows, Aplikace, zdroj ASP.NET. Viz Selhání při spuštění |
Některé stránky MVC vrací prázdný 500 | Razor kompiluje pohledy za běhu: fasáda netstandard chybí v <compilation>, nebo pohled používá C# novější než 5 (?., $"...", nameof) | Přidejte fasádu (Instalace); přesuňte logiku z pohledu do kontroleru |
Stránky zobrazují —, … nebo podobné místo pomlček a diakritiky | Soubory stránek bez značky pořadí bajtů jsou čteny s ANSI kódovou stránkou serveru | <globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8" /> |
Konzole prohlížeče zobrazuje 404 pro HEAD /DocImage.axd?...&page=1 | Handler je registrován bez slovesa HEAD | verb="GET,HEAD,POST" na handleru |
| Dokument se vykresluje, ale ikony nástrojové lišty a načítací spinner chybí | ResPath ukazuje na kořen zdrojů, nebo začíná s / | ResPath: 'doconut-res/images' |
/doconut-res/... požadavky vrací 404 | Modul zdrojů není registrován, runAllManagedModulesForAllRequests je vypnutý, nebo MVC routování zachytí cestu | Záznam <modules> a routes.IgnoreRoute("doconut-res/{*pathInfo}") |
Prohlížeč hlásí The viewer handler could not be reached (no response). | BasePath začíná s / ('/myapp' se stává //myapp/…, jiný host) | BasePath: '/' v kořeni webu; 'myapp' ve virtuálním adresáři |
Prohlížeč hlásí Please make sure your middleware is configured. | DocImage.axd odpověděl 404: handler není v Web.config, MVC routování ho zachytil, nebo BasePath ukazuje jinam | Záznam <handlers>, routes.IgnoreRoute("{resource}.axd/{*pathInfo}") a BasePath |
Každá stránka zobrazuje You Are Not Authorized To View This Page. | Dokument byl otevřen v požadavku bez stavové relace, stavová relace je vypnutá, nebo cookie relace nedosáhne DocImage.axd | Viz Neautorizováno |
| Konverze Web Forms nikdy nevrací | Stránka se blokuje na ConvertAsync — deadlock | Async="true" + RegisterAsyncTask (Plugin převodníku) |
| Každá stránka nese evaluační vodoznak | Nebyla nalezena licence — není v <site root>\wwwroot | Nastavení licence |
Widget se načte, ale jeho první akce vrací 404 | Widget není povolen, nebo jeho basePath není '/DocImage.axd' | options.Add…Widget() a basePath: '/DocImage.axd' |
| První dokument po spuštění nebo recyklaci webu trvá minutu nebo více; pozdější jsou rychlé | Enginy dokumentů se načítají při prvním otevření a antivirová kontrola v reálném čase je skenuje během načítání | Rozjeďte web a udržujte pool běžící — viz První dokument po startu |
| Velké nahrání zobrazí chybovou stránku IIS | Nahrání překračuje maxRequestLength (KB) nebo maxAllowedContentLength (bajtů) | Zvyšte oba nad limit největšího souboru nebo widgetu |
Selhání při spuštění
Výjimka vyhozená v Application_Start nedosáhne prohlížeče: každý požadavek vrací prázdný 500 a protokol IIS neukazuje nic užitečného. Výjimka je v protokolu událostí Windows (Prohlížeč událostí → Windows Logs → Application, zdroj ASP.NET). Běžné jsou:
Plugin bez licence:
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 pluginu musí být v wwwroot, vedle Doconut.Viewer.lic. Chybějící licence a starý soubor TRIAL neposkytují žádné schopnosti pluginu.
Neplatné možnosti:
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.Sestavení, které nelze načíst. ASP.NET načítá každé sestavení v bin\ při spuštění aplikace, takže přesměrování vazby v Web.config, které uvádí verzi chybějící v bin\, zastaví celý web. Zkopírujte přesměrování vygenerovaná NuGet (pro projekt typu SDK, z bin\<YourApp>.dll.config) místo ruční úpravy a zkopírujte je znovu po aktualizacích balíčků.
Nejsi oprávněn zobrazit tuto stránku.
Stránka je odmítnuta, protože požadovaná ASP.NET relace nikdy nedostala dokument. Zkontrolujte v tomto pořadí:
- Otevření proběhlo se stavem relace. MVC kontrolery a Web Forms stránky jej mají. Vlastní
IHttpHandler, který otevírá dokumenty, musí implementovatSystem.Web.SessionState.IRequiresSessionState, jinak nemá relaci k udělení. - Stav relace je zapnutý.
<sessionState mode="Off" />odmítá každou stránku. - Cookie dosáhne obslužného programu. Požadavky widgetu ze stejného původu nesou
ASP.NET_SessionId; skript, volání server‑to‑server nebo stránka z jiného původu bez cookie to nedělá. - Webová farma: otevření sváže prohlížeč (
DocOptions.BrowserId) a stránka předá tiket (objViewer.View(token, access)); každý uzel používá stejný podpisový klíč.
Odmítnutí je obrázek podávaný se stavem 200, asi 2 KB. Monitor, který kontroluje jen stavové kódy, ho počítá jako stránku.
Relace dokumentu nebyla nalezena. Prosím, otevřete dokument znovu.
Token vypršel (posuvné okno, DocOptions.TimeOut, výchozí 60 minut), dokument byl uzavřen, nebo — na jediném serveru — byl recyklován aplikační pool. Recyklace probíhá podle plánu, při každé úpravě Web.config a po nečinnosti poolu (výchozí 20 minut v IIS). Otevřete dokument znovu pro nový token.
Otevření dokumentu selhalo
LicenseException s důvodem odmítnutí — licenční soubor byl nalezen, ale odmítnut (neplatný podpis, manipulace, zařazení na černou listinu nebo sestavení mimo časové okno licence). Otevření je blokováno místo vodoznaku.
LicenseException:
This document type requires the 'Dicom' plugin license.Rozšíření je zpracováváno pouze pluginem (zde DICOM). Plugin je registrován, ale žádná licence již neuděluje jeho schopnost — typicky dočasná licence, která vypršela po spuštění webu. Nainstalujte licenci, která to povolí.
FormatNotSupportedException — žádný prohlížeč (vestavěný, plugin nebo vlastní) nevyžaduje toto rozšíření. DoconutOptions.RegisterViewer může přidat jeden pro vaše vlastní formáty.
InvalidDataException — obsah je poškozený nebo neodpovídá rozšíření (přejmenovaný soubor). Ověřte nahrané soubory před otevřením.
InvalidOperationException:
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().DocumentConverter byl vyřešen bez registrace pluginu Converter.
Výstup vypadá špatně
Stránky nesou vodoznak — nebyla nalezena licence, nebo dočasná licence vypršela. Při aktivní dočasné licenci je vodoznak pouze u výstupu pluginu. Licence, která tuto verzi nepokrývá, vodoznak nemá: otevření vyvolá LicenseException. V IIS musí být licence v wwwroot pod kořenem webu (AppContext.BaseDirectory\wwwroot), ne v bin\. Zkontrolujte IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, License.RejectionMessage).
Starší dokumenty vykreslují poškozený text — zaregistrujte kódové stránky jednou při spuštění:
// Global.asax.cs, Application_Start - před DoconutHost.Initialize.
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);Špatná nebo nahrazená písma — server postrádá písma dokumentu. Windows Server bez Office má mnohem méně písem než vývojový počítač. Nainstalujte písma, nebo nasměrujte FontFolders (na WordConfig a PptConfig) na složku, která je obsahuje.
Obrázková anotace se zobrazuje v prohlížeči, ale export má políčko „Image blocked“ — hostitel obrázku má soukromou nebo smyčkovou adresu, kterou server odmítá načíst. Viz Anotace.
Funkce fungovala v hodnocení, v produkci je tichá
Aktivní dočasná licence uděluje všechny funkce; vaše zakoupená licence poskytuje jen to, co jste si koupili. Bez konkrétní funkce nejsou generovány její soubory pro vyhledávání nebo anotace a registrovaný plugin zastaví web při spuštění. Porovnejte IsCapabilityGranted(...) se všemi funkcemi, které používáte, před nasazením.
Vyhledávání nenajde nic (nebo málo)
- Pro PDF nebylo při otevření dokumentu povoleno
AllowSearch— ve výchozím nastavení jefalse. Word, Excel a PowerPoint mají stejný přepínač. - Obsah je naskenovaný nebo jen obrázek, takže neexistuje textová vrstva k porovnání.
- HTML a Microsoft Project (MPP) nejsou ve výchozím nastavení prohledávatelné: nastavte
DefaultRender = false, aby se vykreslovaly pomocí PDF projekce s textem. - Po inicializaci je
objViewer.CanSearch()false: vyřešený formát nemá vyhledávací cestu. To je oddělené od licence Search; zkontrolujte obojí. - Stránka čte návratovou hodnotu
objViewer.Search(...)— počet přichází ve třetím argumentu, jako zpětné volání.
Stále uvízli?
Problém reprodukujte s minimálním nastavením z Rychlý start. Pokud se tam reprodukuje, kontaktujte podporu s dokumentem, vaším Global.asax.cs, částmi Doconut z Web.config a záznamem události Windows, pokud existuje.
Byla tato stránka užitečná?