Ř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íteNejpravděpodobnější příčinaOprava
Každý požadavek vrací prázdný 500Vý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ý 500Razor 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 diakritikySoubory 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=1Handler je registrován bez slovesa HEADverb="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í 404Modul zdrojů není registrován, runAllManagedModulesForAllRequests je vypnutý, nebo MVC routování zachytí cestuZá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 jinamZá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.axdViz Neautorizováno
Konverze Web Forms nikdy nevracíStránka se blokuje na ConvertAsync — deadlockAsync="true" + RegisterAsyncTask (Plugin převodníku)
Každá stránka nese evaluační vodoznakNebyla nalezena licence — není v <site root>\wwwrootNastavení licence
Widget se načte, ale jeho první akce vrací 404Widget 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 IISNahrá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:

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 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:

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.

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í:

  1. Otevření proběhlo se stavem relace. MVC kontrolery a Web Forms stránky jej mají. Vlastní IHttpHandler, který otevírá dokumenty, musí implementovat System.Web.SessionState.IRequiresSessionState, jinak nemá relaci k udělení.
  2. Stav relace je zapnutý. <sessionState mode="Off" /> odmítá každou stránku.
  3. 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á.
  4. 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:

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

text
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í:

csharp
// 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í je false. 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á?