Řešení problémů

Diagnostika běžných chyb

Každá zpráva níže je doslovný text, který Doconut generuje, uspořádaný podle symptomu. Najděte svou chybu a použijte opravu.

Prohlížeč nezobrazuje nic

Prázdná oblast prohlížeče, konzole prohlížeče plná 404 chyb pro /doconut-res/...
UseDoconutResources() chybí, nebo je umístěna po UseDoconut(). Musí být první v pipeline.

HTTP 500 s:

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

Tokenová bezpečnost Doconut (ve výchozím nastavení zapnutá) vyžaduje stav relace ASP.NET. Přidejte builder.Services.AddSession() a app.UseSession() před větví middleware Doconut. Stav relace také potřebuje cache: v aplikaci minimal-API přidejte builder.Services.AddDistributedMemoryCache(), nebo se aplikace zastaví při spuštění s chybou Unable to resolve service for type 'IDistributedCache' (aplikace MVC a Razor Pages již jednu registrují).

Obrázek chyby v oblasti stránky s textem:

text
You Are Not Authorized To View This Page.

Token byl otevřen jinou relací prohlížeče. Typické příčiny: cookie relace nedorazí k požadavkům na stránku (nastavení cross-origin, politika SameSite, API klient bez cookie úložiště) nebo se aplikace restartovala (nové klíče relace). Toto je bezpečnostní vrstva fungující podle návrhu — viz Základní koncepty → Relace a zabezpečení.

Obrázek chyby s textem:

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

Token vypršel (posuvné okno, výchozí 60 minut — DocOptions.TimeOut) nebo byla relace uzavřena. Znovu otevřete dokument pro získání nového tokenu.

Otevření dokumentu selhává

LicenseException s odmítavou zprávou — licenční soubor byl nalezen, ale odmítnut (neplatný podpis, poškozený, na černé listině nebo sestavení mimo verzi/okno aktualizace licence). Tento stav blokuje otevření (fail-fast) místo degradace na vodoznak; přečtěte License.RejectionMessage pro důvod.

LicenseException:

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

Rozšíření je zpracováváno pouze pluginem (zde: DICOM) a schopnost již není udělena. Zaregistrujte plugin a ověřte lic.IsCapabilityGranted(LicenseCapability.Dicom). Chybějící nebo nedostatečné nečasové oprávnění obvykle selže dříve během AddDoconut().

FormatNotSupportedException:

text
Document format '<extension>' is not supported.

Žádný prohlížeč — vestavěný, plugin nebo vlastní — nepodporuje toto rozšíření. Zkontrolujte seznam podporovaných formátů; pro vlastní formáty můžete použít DoconutOptions.RegisterViewer.

InvalidDataException — obsah souboru je poškozený nebo neodpovídá jeho příponě (např. 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>().

Vyřešili jste DocumentConverter bez registrace pluginu Converter.

Selhání při spuštění

InvalidOperationException zmiňující plugin registrovaný pomocí AddPlugin — aktuální nečasová licence neuděluje tuto schopnost pluginu. Odeberte registraci nebo nainstalujte licenci, která ji uděluje. Chybějící licence a starý soubor TRIAL neudělují žádné schopnosti pluginu.

ArgumentException from 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.

Validace možností selhává rychle — opravte problematickou cestu.

Chyby při sestavování / závislostí

Compiler error CS1705, or at runtime when opening a document:

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

Váš projekt upíná System.Text.Json / System.Text.Encodings.Web pod verzi 10.0.x. Odstraňte downgrade a nechte NuGet obnovit verze, které deklaruje Doconut.NET8.

TypeInitializationException on the first presentation file:

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

Prezentacní engine pevně vyžaduje System.Drawing.Common 6.0.0 (deklarováno balíčkem). Neodstraňujte ani nepřepisujte tuto závislost — každé otevření PPT/PPTX/PPS/POT/ODP selže bez ní.

Výstup vypadá špatně

Stránky nesou vodoznak — aplikace je v evaluačním stavu: nebyl nalezen licenční soubor, vypršelo dočasné nebo předplatné okno, nebo neplatná doména. Prozkoumejte IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, IsValidForDomain, License.RejectionMessage) — reference IDoconutLicenseService na stránce Licensing ukazuje připravený endpoint.

Legacy dokumenty vykreslují poškozený text — kódové stránky nejsou ve výchozím nastavení .NET 8 načteny. Přidejte jednou při spuštění:

csharp
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Špatná nebo nahrazená písma na Linux/Docker — kontejner postrádá písma dokumentu. Nastavte FontFolders (na WordConfig/PptConfig) na připojený adresář s fonty.

Prezentace se otevřou, ale selžou při vykreslování na Linux/macOS — aktuální renderer PPT/PPTX/PPS/POT/ODP vyžaduje nativní libgdiplus plus System.Drawing.EnableUnixSupport=true. Balíček poskytuje System.Drawing.Common 6.0.0, protože je to poslední verze, která tento přepínač podporuje.

Funkce fungovala v evaluačním režimu, v produkci je tichá

Klasické překvapení při nasazení: aktivní dočasná licence uděluje všechny schopnosti; vaše zakoupená licence uděluje jen to, co jste zakoupili. Balíčky pro vyhledávání a anotace mohou zmizet, pokud chybí jejich schopnosti. Registrované pluginy Converter nebo DICOM s nedostatečnou nečasovou licencí selžou během AddDoconut(). Porovnejte IsCapabilityGranted(...) se všemi funkcemi, které před nasazením povolujete.

Vyhledávání nenajde nic (nebo málo)

  • Pro přímý PDF nebylo při otevření povoleno AllowSearch. Word, Excel a PowerPoint vystavují stejný přepínač přes jejich vnořený PdfConfig.
  • Obsah je skenovaný / jen obrázek, takže běžné vyhledávání nemá textovou vrstvu k porovnání. Použijte zdroj s textem nebo PDF projekci, která zachovává text.
  • HTML a MS Project (MPP) nejsou ve výchozím nastavení prohledávatelné — nastavte DefaultRender = false, aby se renderovaly přes PDF projekci s nativní textovou vrstvou. Word, Excel, PowerPoint, TXT, Visio, e‑mail, EPUB a MHT vyhledávají ve svých výchozích nastaveních katalogu.
  • objViewer.CanSearch() je po inicializaci false — rozpoznaný formát nemá standardní cestu pro vyhledávání. Toto hodnocení je oddělené od licence pro vyhledávání; ověřte obojí.

Stále uvízli?

Izolujte problém pomocí minimální aplikace Quick Start; pokud se tam reprodukuje, kontaktujte podporu s dokumentem, vaším Program.cs a výstupem diagnostiky licence.

Byla tato stránka užitečná?