Felsökning

Diagnostisera vanliga fel

Varje meddelande nedan är den exakta text som Doconut producerar, organiserad efter symptom. Hitta ditt fel och tillämpa fixen.

Visaren visar inget

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 pipeline‑kedjan.

Visaren rapporterar The viewer handler could not be reached (no response).
Begäran fick aldrig svar. En vanlig orsak är en BasePath som börjar med /: '/doconut' blir //doconut/DocImage.axd, en begäran till en annan värd. Skriv den utan den inledande snedstrecket (BasePath: 'doconut').

Visaren rapporterar Please make sure your middleware is configured.
Sidans slutpunkt svarade 404: UseDoconut() är inte monterad där klientens BasePath pekar. Med app.Map("/doconut", branch => branch.UseDoconut()) använder klienten BasePath: 'doconut'.

HTTP 500 med:

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

Doconuts token‑säkerhet (aktiverad som standard) kräver ASP.NET‑sessionstillstånd. Lägg till builder.Services.AddSession() och app.UseSession() före Doconut‑middleware‑grenen. Sessionstillståndet behöver också en cache: i en minimal‑API‑app lägg till builder.Services.AddDistributedMemoryCache(), eller så stoppar appen vid start med Unable to resolve service for type 'IDistributedCache' (MVC‑ och Razor‑Pages‑appar registrerar redan en).

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: sessions‑cookien når inte sidans begäran (cross‑origin‑inställning, SameSite‑policy, en API‑klient utan cookie‑burk), eller så startade appen om (nya sessionsnycklar). Detta är säkerhetslagret som fungerar som avsett — se Grundkoncept → Sessioner & Säkerhet. Avslaget är en bild som levereras med status 200, så en monitor som bara kontrollerar statuskoder räknar den som en sida.

En felbild med texten:

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

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

Servern är i ordning men sidan beter sig fel — utan fel någonstans

Detta är de felmodeller som bör misstänkas först efter att ha flyttat en applikation framåt. Alla tre låter servern fungera perfekt, renderar dokumentet korrekt och rapporterar inget i webbläsarkonsolen.

En aktiv spinner som aldrig stannar. Dina visnings‑callback‑funktioner är deklarerade som globala funktioner namngivna efter container‑id‑t — ctlDoc_OnViewerReady() och vänner. Den tidigare visaren slog upp de namnen; den här gör det inte. Händelsen som skulle ha dolt spinnern körs helt enkelt aldrig. Skicka funktionerna som alternativ istället:

javascript
function ctlDoc_OnViewerBusy() { /* visa din busy-indikator */ }
function ctlDoc_OnViewerReady() { /* göm den */ }
function ctlDoc_Copy(text) { /* använd den kopierade texten */ }
function ctlDoc_AutoLoadStatus(pageNum) { /* rapportera framsteg */ }

const objViewer = $('#div_ctlDoc').docViewer({
    // ... dina befintliga alternativ ...
    onViewerBusy:     ctlDoc_OnViewerBusy,
    onViewerReady:    ctlDoc_OnViewerReady,
    onCopy:           ctlDoc_Copy,
    onAutoLoadStatus: ctlDoc_AutoLoadStatus
});

Dokumentet bakom spinnern är i ordning. Den fullständiga alternativlistan finns i Visarkonfiguration.

Saknade visar‑ikoner eller ramverk, sidor annars korrekta. ResPath är tom eller pekar på applikationens rot — korrekt i det tidigare biblioteket, felaktigt här. Den måste ange prefixet som UseDoconutResources() monterar:

javascript
ResPath: 'doconut-res/images'   // eller '<your ResourcesPath>/images'

Trasiga rutor för senare sidor när de serveras från delad lagring. Sidor som fortfarande skrivs svarar med 202 Accepted. En klient utan retryOn409: true behandlar det som en misslyckad bild. Se Distribuerade distributioner.

Öppning av ett dokument misslyckas

LicenseException med ett avvisningsmeddelande — licensfilen hittades men avslogs (ogiltig signatur, manipulerad, svartlistad eller en build utanför licensens versions-/uppdateringsfönster). Detta tillstånd blockerar öppning (fail-fast) snarare än att degraderas till ett vattenmärke; 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). Pluginet är registrerat, men ingen licens beviljar dess funktion längre — vanligtvis en temporär licens som löpte ut efter att appen startade. Installera en licens som beviljar den och verifiera IsCapabilityGranted(LicenseCapability.Dicom) på IDoconutLicenseService. En saknad eller otillräcklig icke‑temporär rättighet misslyckas normalt tidigare, under AddDoconut().

FormatNotSupportedException:

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

Ingen visare — inbyggd, plugin eller anpassad — påstår den utökningen. 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 dess filändelse (t.ex. en omdöpt fil). Validera uppladdningar innan öppning.

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.

Start misslyckas

InvalidOperationException som nämner ett plugin registrerat via AddPlugin — den nuvarande icke‑temporära licensen beviljar inte den plugin‑kapaciteten. Ta bort registreringen eller installera en licens som beviljar den. En saknad licens och en äldre TRIAL‑fil beviljar inga plugin‑kapaciteter.

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

Bygg‑ / beroende‑fel

Paketet kommer inte att installeras alls — Doconut.NETStandard riktar sig mot netstandard2.1, så NuGet avvisar ett .NET Framework‑projekt. Detta är inte ett lösbart återställningsfel: .NET Framework kan inte konsumera netstandard2.1. Använd paketet Doconut.NETFramework istället.

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

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

ditt projekt har låst System.Text.Json eller System.Text.Encodings.Web under 9.0.x‑beroendena som deklarerats av Doconut.NETStandard. Ta bort nedgradering och låt NuGet återställa paketgrafen (System.Text.Json 9.0.0 och System.Text.Encodings.Web 9.0.0 enligt paketet).

En mur av kompileringsfel omedelbart efter att paketet uppdaterats — detta är förväntat. 26.8.0 har en annan API‑yta än 26.7.0, inte en kompatibel uppdatering. De flesta fel är using‑raderna som flyttades till rot‑Doconut‑namnutrymmet; arbeta igenom Migrera till .NET Standard 2.1 snarare än att patcha dem en efter en.

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 (deklarerat 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 vattenmärke — appen är i ett evalueringsläge: ingen licensfil hittades, en utgången temporär licens eller en ogiltig domän. Under en aktiv temporär licens är endast plugin‑utdata vattenmärkta. En build som släppts efter ett betalt licensabonnemangs datum är inte vattenmärkt: öppning kastar LicenseException. Inspektera IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, IsValidForDomain, License.RejectionMessage) — Licenssidan's IDoconutLicenseService‑referens visar en färdig endpoint.

Äldre dokument renderar förvrängd text — kodsidans kodningar laddas inte som standard. Lägg till en gång vid start:

csharp
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Felaktiga eller ersatta typsnitt — servern saknar dokumentets typsnitt. Installera dem, eller peka FontFolders (på WordConfig/PptConfig) mot en mapp som innehåller dem.

En bildkommentar visas i visaren men exporten har en "Image blocked"-ruta — bildens värd har en privat eller loopback‑adress, som servern vägrar att hämta. Se Anmärkningar.

Funktionen fungerade i utvärdering, tyst i produktion

Den klassiska go-live-överraskningen: en aktiv Tillfällig licens ger varje funktion; din köpta licens ger bara det du köpte. Sök- och annoteringspaket kan försvinna när deras funktioner saknas. Registrerad 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 driftsättning.

Sök hittar ingenting (eller för lite)

  • För en direkt PDF var AllowSearch inte aktiverad vid öppning. Word, Excel och PowerPoint visar samma omkopplare via deras inbäddade PdfConfig.
  • Innehållet är skannat/endast bild, så vanlig Sök har inget textlager att matcha mot. 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å att 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.
  • Sidan läser returvärdet från objViewer.Search(...) — räknaren kommer i dess tredje argument, en återuppringning.

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 hjälpsam?