Felsökning

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

Visaren visar ingenting

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

HTTP 500 med:

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

Doconuts token‑säkerhet (aktiverad som standard) kräver ASP.NET‑sessionsstatus. Lägg till builder.Services.AddSession() och app.UseSession() före Doconut‑middleware‑grenen.

En felbild i sidområdet med texten:

You Are Not Authorized To View This Page.

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

En felbild med texten:

Document session not found. Please re-open document.

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

Det går inte att öppna ett dokument

LicenseException med ett avvisningsmeddelande — licensfilen hittades men avvisades (ogiltig signatur, manipulerad, svartlistad eller en byggnad utanför licensens versions‑/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:

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:

Document format '<extension>' is not supported.

Ingen visare — inbyggd, plugin eller anpassad — stödjer den filändelsen. Kontrollera listan över stödda 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:

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

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

Startfel

InvalidOperationException som nämner ett plugin registrerat via AddPlugin — den aktuella 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 beviljar inga plugin‑funktioner.

ArgumentException from AddDoconut():

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 felaktiga sökvägen.

Bygg‑ / beroende‑fel

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

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

Ditt projekt har låst System.Text.Json / System.Text.Encodings.Web till en version under 10.0.x. Ta bort nedgradering och låt NuGet återställa de versioner som Doconut.NET8 deklarerar.

TypeInitializationException on the first presentation file:

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 detta beroende — 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 hittades, ett utgånget tillfälligt eller prenumerationsfönster, eller en ogiltig domän. Inspektera IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, IsValidForDomain, License.RejectionMessage) — licenssidan visar en färdig endpoint för IDoconutLicenseService.

Legacy‑dokument renderar förvrängd text — kodsidsteg är inte laddade som standard i .NET 8. Lägg till en gång vid start:

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 aktuella PPT/PPTX/PPS/POT/ODP‑renderaren kräver native libgdiplus samt System.Drawing.EnableUnixSupport=true. Paketet levererar System.Drawing.Common 6.0.0 eftersom det är den sista versionen som stödjer denna switch.

Funktion fungerade i utvärdering, tyst i produktion

Den klassiska go‑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(...) med 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/bild‑endast, så normal sökning har inget textlager att matcha. Använd en källa med text 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 är separat från sök‑licensen; verifiera båda.

Fortfarande fast?

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