Řešení problémů

Diagnostikujte běžné chyby

Každá zpráva níže je doslovný text, který Doconut produkuje, 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.

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 stránky (nastavení cross-origin, politika SameSite, API klient bez úložiště cookie), nebo se aplikace restartovala (nové klíče relace). Toto je bezpečnostní vrstva fungující podle návrhu — viz Core Concepts → Sessions & Security.

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

Otevírání dokumentu selhává

LicenseException s odmítavou zprávou — soubor licence byl nalezen, ale odmítnut (neplatný podpis, poškozený, na černé listině nebo sestavení mimo verzi/okno aktualizace licence). Tento stav blokuje otevírání (rychlé selhání) 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á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 ani 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 rozšíření (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 zmiňující plugin registrovaný přes 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 z 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.

Rychlé selhání při validaci možností — opravte problematickou cestu.

Chyby sestavení / závislostí

Chyba kompilátoru CS1705, nebo za běhu při otevírání dokumentu:

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

Váš projekt uzamkl System.Text.Json nebo System.Text.Encodings.Web na verzi pod 8.0.x, která je deklarována v Doconut.NET6. Odstraňte downgrade a nechte NuGet obnovit graf balíčků (System.Text.Json 8.0.6 a System.Text.Encodings.Web 8.0.0 v auditovaném balíčku 26.7.0).

TypeInitializationException při prvním prezentačním souboru:

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 soubor licence, 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.

Starší dokumenty vykreslují poškozený text — kódové stránky nejsou ve výchozím nastavení .NET 6 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í 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í verzi, 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ý / pouze 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 vykreslovaly přes PDF projekci s nativní textovou vrstvou. Word, Excel, PowerPoint, TXT, Visio, e‑mail, EPUB a MHT vyhledávají ve výchozím nastavení svého katalogu.
  • objViewer.CanSearch() je po inicializaci false — rozpoznaný formát nemá standardní cestu pro 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á?