Řešení problémů

Diagnostika běžných chyb

Každá zpráva níže je doslovný text, který Doconut produkuje, uspořádaný podle symptomu. Najděte svou chybu, aplikujte 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ěno po UseDoconut(). Musí být první v pipeline.

HTTP 500 s:

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

Bezpečnost tokenu 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.

Obrázek s chybou v oblasti stránky zobrazující:

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 (cross‑origin nastavení, 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 s chybou zobrazující:

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 nový token.

Otevření dokumentu selhává

LicenseException with a rejection message — 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í — neakceptuje 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.

Spuštění selhává

InvalidOperationException mentioning a plugin registered via 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í fail‑fast — opravte problematickou cestu.

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

Compiler error CS1705, nebo za běhu při otevírání dokumentu:

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

Váš projekt uzamkl 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

Prezentační 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) — odkaz na IDoconutLicenseService na stránce Licencování ukazuje připravený endpoint.

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

csharp
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

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

Prezentace se otevřou, ale selžou při renderování na Linux/macOS — aktuální renderér 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 to je 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é povolujete před nasazením.

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 výchozích nastaveních katalogu.
  • objViewer.CanSearch() je po inicializaci false — rozpoznaný formát nemá standardní cestu vyhledávání. Toto rozhodnutí 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á?