Felsökning

Diagnostisera vanliga fel

Varje meddelande nedan är den bokstavliga text som Doconut producerar, organiserad efter symptom. Hitta ditt fel, tillämpa lösningen.

Visaren visar ingenting

Tomt visningsområde, webbläsarkonsolen full av 404-fel för /doconut-res/...
UseDoconutResources() saknas, eller placerad efter UseDoconut(). Den måste komma först i pipelinen.

HTTP 500 med:

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

En felbild i sidområdet med texten:

text
You Are Not Authorized To View This Page.

Tokenet öppnades av en annan webbläsarsession. Vanliga orsaker: sessionskakan når inte sidförfrågningarna (cross-origin‑inställning, SameSite‑policy, en API‑klient utan cookie‑behållare), eller så startades appen om (nya sessionsnycklar). Detta är säkerhetslagret som fungerar som designat — se Kärnkoncept → Sessioner & Säkerhet.

En felbild med texten:

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

Tokenet har gått ut (glidande fönster, standard 60 minuter — DocOptions.TimeOut) eller sessionen har stängts. Öppna dokumentet igen för ett nytt token.

Öppning av ett dokument misslyckas

LicenseException med ett avvisningsmeddelande — licensfilen hittades men avvisades (ogiltig signatur, manipulerad, svartlistad, eller en byggnad utanför licensens version/uppdateringsfönster). Detta tillstånd blockerar öppning (fail-fast) istället för att degraderas till ett vattenstämpel; läs License.RejectionMessage för orsaken.

LicenseException:

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

Utökningen hanteras endast av ett plugin (här: DICOM) och funktionen är inte längre beviljad. Registrera pluginet och verifiera lic.IsCapabilityGranted(LicenseCapability.Dicom). En saknad eller otillräcklig icke‑tillfällig rättighet misslyckas normalt tidigare under AddDoconut().

FormatNotSupportedException:

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

Ingen visare — inbyggd, plugin eller anpassad — stöder den filändelsen. Kontrollera listan över stödjade format; för egna format kan DoconutOptions.RegisterViewer lägga till en.

InvalidDataException — filinnehållet är korrupt eller matchar inte filändelsen (t.ex. en omdöpt fil). Validera uppladdningar innan de öppnas.

InvalidOperationException:

text
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().

Du löste DocumentConverter utan att registrera Converter‑pluginet.

Uppstart misslyckas

InvalidOperationException som nämner ett plugin registrerat via AddPlugin — den nuvarande icke‑tillfälliga licensen beviljar inte den plugin‑funktionen. Ta bort registreringen eller installera en licens som beviljar den. En saknad licens och en äldre TRIAL‑fil ger inga plugin‑funktioner.

ArgumentException från 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.

Fail-fast‑validering av alternativ — åtgärda den felande sökvägen.

Bygg‑ / beroende‑fel

Compiler error CS1705, eller vid körning när ett dokument öppnas:

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

Ditt projekt har låst System.Text.Json eller System.Text.Encodings.Web till en version under 8.0.x som deklarerats av Doconut.NET6. Ta bort nedgraderingen och låt NuGet återställa paketgrafen (System.Text.Json 8.0.6 och System.Text.Encodings.Web 8.0.0 i det granskade paketet 26.7.0).

TypeInitializationException på den första presentationsfilen:

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

Presentationsmotorn kräver hårt System.Drawing.Common 6.0.0 (deklarerad av paketet). Ta inte bort eller åsidosätt det beroendet — varje öppning av PPT/PPTX/PPS/POT/ODP misslyckas utan det.

Utdata ser felaktig ut

Sidor har ett vattenstämpel — appen är i ett utvärderingsläge: ingen licensfil hittad, ett utgånget tillfälligt eller prenumerationsfönster, eller en ogiltig domän. Inspektera IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, IsValidForDomain, License.RejectionMessage) — licenssidan IDoconutLicenseService‑referensen visar en färdig endpoint.

Legacy‑dokument renderar förvrängd text — kodsidstegskodningar laddas inte som standard i .NET 6. Lägg till en gång vid uppstart:

csharp
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Felaktiga eller ersatta typsnitt på Linux/Docker — containern saknar dokumentets typsnitt. Peka FontFolders (på WordConfig/PptConfig) mot en monterad typsnittskatalog.

Presentationer öppnas men renderas inte på Linux/macOS — den nuvarande PPT/PPTX/PPS/POT/ODP‑renderaren kräver native libgdiplus plus System.Drawing.EnableUnixSupport=true. Paketet levererar System.Drawing.Common 6.0.0 eftersom det är den sista versionen som hedrar denna switch.

Funktion fungerade i utvärdering, tyst i produktion

Den klassiska gå‑live‑överraskningen: en aktiv tillfällig licens beviljar alla funktioner; din köpta licens beviljar bara det du köpt. Sök‑ och annoteringspaket kan försvinna när deras funktioner saknas. Registrerade Converter‑ eller DICOM‑plugin med en otillräcklig icke‑tillfällig licens misslyckas under AddDoconut(). Jämför IsCapabilityGranted(...) mot varje funktion du aktiverar innan distribution.

Sökning hittar inget (eller för lite)

  • För en direkt PDF var AllowSearch inte aktiverat vid öppning. Word, Excel och PowerPoint exponerar samma switch via deras inbäddade PdfConfig.
  • Innehållet är skannat/endast bild, så normal Sökning har inget textlager att matcha. Använd en textbärande källa eller en PDF‑projektion som bevarar text.
  • HTML och MS Project (MPP) är inte sökbara i sina standardinställningar — sätt DefaultRender = false så de renderas via en PDF‑projektion med ett inbyggt textlager. Word, Excel, PowerPoint, TXT, Visio, e‑post, EPUB och MHT söker i sina katalogstandarder.
  • objViewer.CanSearch() är false efter initiering — det lösta formatet har ingen standard sökväg. Detta beslut är separat från Sök‑licensen; verifiera båda.

Fortfarande fast?

Isolera problemet mot den minimala Quick Start‑appen; om det reproduceras där, kontakta support med dokumentet, din Program.cs och licensdiagnostikens utdata.

Var den här sidan till hjälp?