פתרון בעיות
אבחון שגיאות נפוצות
רבות משגיאות System.Web אינן זורמות חריגה שניתן לראות: העמוד מחזיר 500 ריק, אייקון מחזיר 404, או בקשה לעולם לא חוזרת. דף זה מאורגן לפי מה שאתה רואה. הודעות מצוטטות הן הטקסט המילולי ש‑Doconut מייצר.
תסמינים במבט כולל
| מה שאתה רואה | הסיבה הסבירה ביותר | פתרון |
|---|---|---|
כל בקשה מחזירה 500 ריק | חריגה ב‑Application_Start: תוסף ללא רישיון, אפשרות לא חוקית, תצורת חווה לא שלמה — או הפנייה מחודשת שמציינת גרסה שאינה ב‑bin\ | יומן אירועי Windows, Application, מקור ASP.NET. ראה תקלות אתחול |
חלק מעמודי MVC מחזירים 500 ריק | Razor מקמפל תצוגות בזמן ריצה: הפאסאד של netstandard חסר ב‑<compilation>, או שהתצוגה משתמשת ב‑C# חדש יותר מ‑5 (?., $"...", nameof) | הוסף את הפאסאד (התקנה); העבר לוגיקה מהתצוגה לבקר |
עמודים מציגים —, … או דומה במקום מקפים ונקודות | קבצי דף ללא סימן סדר בתים נקראים בעזרת קוד העמודה ANSI של השרת | <globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8" /> |
קונסולת הדפדפן מציגה 404 עבור HEAD /DocImage.axd?...&page=1 | המתאם רשום ללא הפועל HEAD | verb="GET,HEAD,POST" במתאם |
| המסמך מוצג, אך סמלוני סרגל הכלים וספינר הטעינה חסרים | ResPath מצביע על שורש המשאבים, או מתחיל ב‑/ | ResPath: 'doconut-res/images' |
בקשות /doconut-res/... מחזירות 404 | מודול המשאבים אינו רשום, runAllManagedModulesForAllRequests כבוי, או ניתוב MVC תופס את הנתיב | הכניסה <modules>, ו‑routes.IgnoreRoute("doconut-res/{*pathInfo}") |
הצופה מדווח The viewer handler could not be reached (no response). | BasePath מתחיל ב‑/ ('/myapp' הופך ל‑//myapp/…, מארח אחר) | BasePath: '/' בשורש האתר; 'myapp' בתיקייה וירטואלית |
הצופה מדווח Please make sure your middleware is configured. | DocImage.axd ענה 404: המתאם אינו ב‑Web.config, ניתוב MVC תפס אותו, או BasePath מצביע למקום אחר | הכניסה <handlers>, routes.IgnoreRoute("{resource}.axd/{*pathInfo}"), ו‑BasePath |
כל עמוד מציג You Are Not Authorized To View This Page. | המסמך נפתח בבקשה ללא מצב סשן, מצב סשן כבוי, או שהקוקי של הסשן אינו מגיע ל‑DocImage.axd | ראה לא מורשה |
| המרת Web Forms לעולם לא מחזירה | העמוד חוסם ב‑ConvertAsync — מצב קפיאה | Async="true" + RegisterAsyncTask (תוסף ממיר) |
| כל עמוד נושא סימן מים של הערכה | לא נמצא רישיון — הוא אינו ב‑<site root>\wwwroot | הגדרת רישיון |
ווידג'ט נטען, אך הפעולה הראשונה שלו מחזירה 404 | הווידג'ט אינו מופעל, או שה‑basePath שלו אינו '/DocImage.axd' | options.Add…Widget(), ו‑basePath: '/DocImage.axd' |
| המסמך הראשון אחרי שהאתר מתחיל או מתרענן לוקח דקה או יותר; המסמכים הבאים מהירים | מנועי המסמך נטענים בפתיחה הראשונה, ואנטיוירוס בזמן אמת סורק אותם בזמן הטעינה | חמם את האתר והמשך להריץ את המאגר — ראה המסמך הראשון אחרי התחלה |
| העלאה גדולה מציגה דף שגיאת IIS | ההעלאה חורגת מ‑maxRequestLength (KB) או maxAllowedContentLength (בייטים) | העלה את שני הגבולות מעל הקובץ הגדול ביותר או מגבלת הווידג'ט שלך |
תקלות אתחול
חריגה שנזרקת ב‑Application_Start אינה מגיעה לדפדפן: כל בקשה מחזירה 500 ריק, ולוג ה‑IIS אינו מציג דבר מועיל. החריגה נמצאת ב‑יומן אירועי Windows (Event Viewer → Windows Logs → Application, מקור ASP.NET). הרגילים:
תוסף ללא רישיון:
The Converter plugin is registered via AddPlugin but no active license grants Converter.
Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.ה‑Doconut.Viewer.<Capability>.lic של התוסף חייב להיות ב‑wwwroot, ליד Doconut.Viewer.lic. רישיון חסר וקובץ TRIAL מיושן אינם מעניקים יכולות לתוסף.
אפשרויות לא חוקיות:
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.אוסף שלא ניתן לטעון.
ASP.NET טוען כל אוסף ב‑bin\ כאשר היישום מתחיל, ולכן הפנייה מחודשת ב‑Web.config שמציינת גרסה שחסרה ב‑bin\ מפסיקה את כל האתר. העתק את ההפניות ש‑NuGet יצר (לפרויקט בסגנון SDK, מ‑bin\<YourApp>.dll.config) במקום לערוך אותן ידנית, והעתק אותן שוב לאחר עדכוני חבילות.
אינך מורשה לצפות בדף זה.
הדף נדחה מכיוון שמפגש ה‑ASP.NET המבקש מעולם לא קיבל את המסמך. בדוק, לפי הסדר:
- הפתיחה רצה עם מצב מפגש. ב‑MVC controllers וב‑Web Forms pages יש זאת.
IHttpHandlerמותאם אישית שפותח מסמכים חייב לממשSystem.Web.SessionState.IRequiresSessionState, אחרת אין לו מפגש להקצאה. - מצב המפגש פעיל.
<sessionState mode="Off" />מסרב לכל דף. - הקוקי מגיע למטפל. הבקשות מאותו מקור של הווידג'ט נושאות
ASP.NET_SessionId; סקריפט, קריאה משרת-לשרת, או דף חוצה מקור ללא קookies לא נושא. - חוות שרתים: הפתיחה קושרת את הדפדפן (
DocOptions.BrowserId) והדף מעביר את הכרטיס (objViewer.View(token, access)); כל צומת משתמש במפתח החתימה זהה.
הדחייה היא תמונה שמוגשת עם סטטוס 200, בגודל כ‑2 ק״ב. מנגנון שמבצע בדיקה רק של קודי סטטוס מחשיב זאת כדף.
לא נמצא מפגש מסמך. אנא פתח את המסמך מחדש.
הטוקן פג (חלון זמן מתגלגל, DocOptions.TimeOut, ברירת מחדל 60 דקות), המסמך נסגר, או — בשרת יחיד — מאגר היישום נמחזר. מחזור מתבצע לפי לוח זמנים, בכל עריכת Web.config, ולאחר זמן ההמתנה של המאגר (20 דקות כברירת מחדל ב‑IIS). פתח את המסמך שוב לקבלת טוקן חדש.
פתיחת מסמך נכשלה
LicenseException עם סיבת דחייה — קובץ הרישיון נמצא אך נדחה (חתימה לא תקפה, שינוי, רשימה שחורה, או בנייה מחוץ לחלון גרסת הרישיון). הפתיחה חסומה במקום למקם סימן מים.
LicenseException:
This document type requires the 'Dicom' plugin license.הסיומת מטופלת רק על ידי תוסף (כאן DICOM). התוסף רשום, אך אין רישיון שמעניק את היכולת שלו יותר — בדרך כלל רישיון זמני שפג לאחר שהאתר התחיל. התקן רישיון שמעניק זאת.
FormatNotSupportedException — אין מציג (מובנה, תוסף או מותאם) שתומך בסיומת. DoconutOptions.RegisterViewer יכול להוסיף אחד לפורמטים שלך.
InvalidDataException — התוכן פגום או אינו תואם את הסיומת (קובץ ששונה שמו). אמת העלאות לפני הפתיחה.
InvalidOperationException:
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().DocumentConverter נפתר ללא רישום תוסף הממיר.
הפלט נראה שגוי
דפים נושאים סימן מים — לא נמצא רישיון, או שהרישיון הזמני פג. תחת רישיון זמני פעיל, רק פלט של תוסף מסומן במים. רישיון שלא מכסה גרסה זו אינו מסומן במים: הפתיחה זורקת LicenseException. תחת IIS, הרישיון חייב להיות ב‑wwwroot תחת שורש האתר (AppContext.BaseDirectory\wwwroot), ולא ב‑bin\. בדוק את IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, License.RejectionMessage).
מסמכי מורשת מציגים טקסט משובש — רשום את קידודי דפי הקוד פעם אחת, באתחול:
// Global.asax.cs, Application_Start - לפני DoconutHost.Initialize.
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);גופנים שגויים או מוחלפים — השרת חסר את הגופנים של המסמך. Windows Server ללא Office מכיל פחות גופנים מאשר מכונת פיתוח. התקן את הגופנים, או הפנה את FontFolders (ב‑WordConfig ו‑PptConfig) לתיקייה שמכילה אותם.
הערת תמונה מוצגת במציג אך הייצוא מציג תיבת "תמונה חסומה" — למארח התמונה יש כתובת פרטית או לולאה, שהשרת מסרב לאחזר. ראה הערות.
תכונה עבדה במצב הערכה, שקטה בייצור
רישיון זמני פעיל מעניק כל יכולת; הרישיון שרכשת מעניק רק את מה שרכשת. ללא יכולת, קבצי החיפוש או ההערות שלו אינם נשלחים, ותוסף רשום עוצר את האתר באתחול. השווה את IsCapabilityGranted(...) עם כל תכונה שאתה משתמש בה לפני הפריסה.
חיפוש אינו מוצא דבר (או מעט מדי)
- ל‑PDF,
AllowSearchלא היה מופעל כאשר המסמך נפתח — ברירת המחדל היאfalse. Word, Excel ו‑PowerPoint מציגים את אותו המתג. - התוכן סרוק או רק תמונה, ולכן אין שכבת טקסט להתאים.
- HTML ו‑Microsoft Project (MPP) אינם ניתנים לחיפוש בברירות המחדל שלהם: הגדר
DefaultRender = falseכדי שהם יופיעו דרך פרויקט PDF עם טקסט. objViewer.CanSearch()הואfalseלאחר האתחול: הפורמט שנפתר אינו כולל נתיב חיפוש. זה נפרד מרישיון החיפוש; בדוק את שניהם.- הדף קורא את ערך ההחזרה של
objViewer.Search(...)— הספירה מגיעה בארגומנט השלישי שלו, קריאה חוזרת.
עדיין תקועים?
שחזרו את הבעיה עם ההגדרה המינימלית מ-התחלה מהירה. אם היא מתרחשת שם, פנו לתמיכה עם המסמך, Global.asax.cs שלכם, החלקים של Doconut בWeb.config, ורשומת יומן האירועים של Windows אם קיימת.
האם דף זה היה מועיל?