การแก้ไขปัญหา
วินิจฉัยข้อผิดพลาดทั่วไป
หลายความล้มเหลวของ System.Web ไม่ได้โยนข้อยกเว้นที่คุณเห็น: หน้าเว็บตอบด้วย 500 ว่าง, ไอคอนแสดง 404, หรือคำขอไม่เคยคืนค่า. หน้านี้จัดระเบียบตามสิ่งที่คุณสังเกต. ข้อความที่อ้างอิงเป็นข้อความดิบที่ Doconut สร้างขึ้น.
อาการโดยสังเขป
| สิ่งที่คุณเห็น | สาเหตุที่เป็นไปได้มากที่สุด | วิธีแก้ |
|---|---|---|
ทุก คำขอตอบด้วย 500 ว่าง | ข้อยกเว้นใน Application_Start: ปลั๊กอินไม่มีใบอนุญาต, ตัวเลือกไม่ถูกต้อง, การกำหนดค่า farm ไม่สมบูรณ์ — หรือการเปลี่ยนเส้นทางการผูกที่ระบุเวอร์ชันที่ไม่มีใน bin\ | บันทึกเหตุการณ์ของ Windows, แอปพลิเคชัน, แหล่ง ASP.NET. ดู การล้มเหลวขณะเริ่มต้น |
บาง หน้า MVC ตอบด้วย 500 ว่าง | Razor คอมไพล์วิวในเวลารัน: ส่วนหน้า netstandard ขาดจาก <compilation>, หรือวิวใช้ C# ที่ใหม่กว่า 5 (?., $"...", nameof) | เพิ่มส่วนหน้า (การติดตั้ง); ย้ายตรรกะจากวิวไปยังคอนโทรลเลอร์ |
หน้าแสดง —, … หรือคล้ายกันแทนเครื่องหมายขีดและสำเนียง | ไฟล์หน้าโดยไม่มี byte-order mark จะถูกอ่านด้วยหน้าโค้ด ANSI ของเซิร์ฟเวอร์ | <globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8" /> |
คอนโซลของเบราว์เซอร์แสดง 404 สำหรับ HEAD /DocImage.axd?...&page=1 | ตัวจัดการถูกลงทะเบียนโดยไม่มี verb HEAD | verb="GET,HEAD,POST" บนตัวจัดการ |
| เอกสารถูกแสดง, แต่ไอคอนแถบเครื่องมือและสปินเนอร์โหลดหายไป | ResPath ชี้ไปที่รากของทรัพยากร, หรือเริ่มด้วย / | ResPath: 'doconut-res/images' |
คำขอ /doconut-res/... ตอบด้วย 404 | โมดูลทรัพยากรไม่ได้ลงทะเบียน, runAllManagedModulesForAllRequests ปิดอยู่, หรือการ routing ของ MVC จับเส้นทาง | รายการ <modules>, และ routes.IgnoreRoute("doconut-res/{*pathInfo}") |
Viewer รายงาน The viewer handler could not be reached (no response). | BasePath เริ่มด้วย / ('/myapp' กลายเป็น //myapp/…, โฮสต์อื่น) | BasePath: '/' ที่รากของไซต์; 'myapp' ในไดเรกทอรีเสมือน |
Viewer รายงาน Please make sure your middleware is configured. | DocImage.axd ตอบ 404: ตัวจัดการไม่อยู่ใน Web.config, การ routing ของ MVC จับมัน, หรือ BasePath ชี้ไปที่อื่น | รายการ <handlers>, routes.IgnoreRoute("{resource}.axd/{*pathInfo}"), และ BasePath |
ทุกหน้าแสดง You Are Not Authorized To View This Page. | เอกสารถูกเปิดในคำขอที่ไม่มี session state, session state ปิดอยู่, หรือคุกกี้เซสชันไม่ถึง DocImage.axd | ดู ไม่ได้รับอนุญาต |
| การแปลง Web Forms ไม่เคยคืนค่า | หน้าบล็อกที่ ConvertAsync — deadlock | Async="true" + RegisterAsyncTask (ปลั๊กอินแปลง) |
| ทุกหน้ามีลายน้ำการประเมิน | ไม่พบใบอนุญาต — ไม่อยู่ใน <site root>\wwwroot | ตั้งค่าใบอนุญาต |
วิดเจ็ตโหลด, แต่การกระทำแรกตอบด้วย 404 | วิดเจ็ตไม่ได้เปิดใช้งาน, หรือ basePath ของมันไม่เป็น '/DocImage.axd' | options.Add…Widget(), และ basePath: '/DocImage.axd' |
| เอกสารแรกหลังจากไซต์เริ่มหรือรีไซเคิลใช้เวลาหนึ่งนาทีหรือมากกว่า; เอกสารต่อมาจะเร็ว | เอนจินเอกสารโหลดเมื่อเปิดครั้งแรก, และแอนตี้ไวรัสแบบเรียลไทม์สแกนขณะโหลด | อุ่นไซต์และรักษา pool ให้ทำงาน — ดู เอกสารแรกหลังการเริ่มต้น |
| การอัปโหลดขนาดใหญ่แสดงหน้าข้อผิดพลาดของ IIS | การอัปโหลดเกิน maxRequestLength (KB) หรือ maxAllowedContentLength (bytes) | เพิ่มค่าทั้งสองให้สูงกว่าขนาดไฟล์หรือวิดเจ็ตสูงสุดของคุณ |
การล้มเหลวขณะเริ่มต้น
ข้อยกเว้นที่ถูกโยนใน Application_Start ไม่ถึงเบราว์เซอร์: ทุกคำขอตอบด้วย 500 ว่าง, และบันทึก IIS ไม่แสดงอะไรที่เป็นประโยชน์. ข้อยกเว้นอยู่ใน บันทึกเหตุการณ์ของ Windows (ตัวดูเหตุการณ์ → บันทึกของ Windows → แอปพลิเคชัน, แหล่ง 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ที่กำหนดเองซึ่งเปิดเอกสารต้อง implementSystem.Web.SessionState.IRequiresSessionState, หรือจะไม่มีเซสชันให้มอบหมาย. - สถานะเซสชันเปิดอยู่
<sessionState mode="Off" />ปฏิเสธทุกหน้า. - คุกกี้ถึงตัวจัดการ คำขอ same-origin ของวิดเจ็ตจะพา
ASP.NET_SessionId; สคริปต์, การเรียก server-to-server, หรือหน้าข้ามต้นทางที่ไม่มีคุกกี้จะไม่ได้. - ฟาร์มเว็บ: การเปิดผูกกับเบราว์เซอร์ (
DocOptions.BrowserId) และหน้าจะส่งตั๋ว (objViewer.View(token, access)); ทุกโหนดใช้คีย์การลงนามเดียวกัน.
การปฏิเสธเป็นภาพที่ให้บริการพร้อมสถานะ 200, ขนาดประมาณ 2 KB. ตัวตรวจสอบที่ตรวจสอบเฉพาะรหัสสถานะจะนับเป็นหน้า.
ไม่พบเซสชันเอกสาร. โปรดเปิดเอกสารใหม่.
โทเคนหมดอายุ (sliding window, DocOptions.TimeOut, ค่าเริ่มต้น 60 นาที), เอกสารถูกปิด, หรือ — บนเซิร์ฟเวอร์เดียว — พูลแอปพลิเคชันถูกรีไซเคิล การรีไซเคิลเกิดตามกำหนดเวลา, ทุกการแก้ไข Web.config, และหลังจากเวลาหมดการว่างของพูล (20 นาทีตามค่าเริ่มต้นใน IIS). เปิดเอกสารอีกครั้งเพื่อรับโทเคนใหม่.
การเปิดเอกสารล้มเหลว
LicenseException ด้วยเหตุผลการปฏิเสธ — พบไฟล์ใบอนุญาตแต่ถูกปฏิเสธ (ลายเซ็นไม่ถูกต้อง, การดัดแปลง, การบล็อก, หรือการสร้างที่อยู่นอกช่วงเวอร์ชันของใบอนุญาต). การเปิดถูกบล็อกแทนที่จะใส่น้ำลายน้ำ.
LicenseException:
This document type requires the 'Dicom' plugin license.ส่วนขยายนี้จัดการได้เฉพาะโดยปลั๊กอิน (ที่นี่คือ DICOM). ปลั๊กอินได้ลงทะเบียนแล้ว, แต่ไม่มีใบอนุญาตใดให้ความสามารถนี้อีก — ปกติเป็นใบอนุญาต Temporary ที่หมดอายุหลังจากเว็บไซต์เริ่มทำงาน. ติดตั้งใบอนุญาตที่ให้สิทธิ์นี้.
FormatNotSupportedException — ไม่มี viewer (built-in, plugin, หรือ custom) ที่รองรับส่วนขยายนี้. DoconutOptions.RegisterViewer สามารถเพิ่มหนึ่งรายการสำหรับรูปแบบของคุณเอง.
InvalidDataException — เนื้อหาเสียหายหรือไม่ตรงกับส่วนขยาย (ไฟล์ที่เปลี่ยนชื่อ). ตรวจสอบการอัปโหลดก่อนเปิด.
InvalidOperationException:
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().DocumentConverter ถูกแก้ไขโดยไม่ได้ลงทะเบียนปลั๊กอิน Converter.
ผลลัพธ์ดูผิดพลาด
หน้ามีน้ำลายน้ำ — ไม่พบใบอนุญาต, หรือใบอนุญาต Temporary หมดอายุ. ภายใต้ใบอนุญาต Temporary ที่ใช้งานอยู่, เฉพาะผลลัพธ์จากปลั๊กอินเท่านั้นที่มีน้ำลายน้ำ. ใบอนุญาตที่ไม่ครอบคลุมเวอร์ชันนี้จะไม่มีน้ำลายน้ำ: การเปิดจะโยน LicenseException. ภายใต้ IIS, ใบอนุญาตต้องอยู่ใน wwwroot ใต้รูทของไซต์ (AppContext.BaseDirectory\wwwroot), ไม่ใช่ใน bin\. ตรวจสอบ IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, License.RejectionMessage).
เอกสาร Legacy แสดงข้อความเป็นอักขระผิด — ลงทะเบียนการเข้ารหัส code-page ครั้งเดียว, ที่การเริ่มต้น:
// Global.asax.cs, Application_Start - ก่อน DoconutHost.Initialize.
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);ฟอนต์ผิดหรือถูกแทนที่ — เซิร์ฟเวอร์ไม่มีฟอนต์ของเอกสาร. Windows Server ที่ไม่มี Office มีฟอนต์น้อยกว่ามากเมื่อเทียบกับเครื่องพัฒนา. ติดตั้งฟอนต์, หรือชี้ FontFolders (บน WordConfig และ PptConfig) ไปยังโฟลเดอร์ที่เก็บฟอนต์เหล่านั้น.
การคอมเมนต์รูปภาพแสดงใน viewer แต่การส่งออกมีกล่อง "Image blocked" — โฮสต์ของรูปภาพมีที่อยู่ส่วนตัวหรือ loopback, ซึ่งเซิร์ฟเวอร์ปฏิเสธการดึง. ดู คำอธิบาย.
ฟีเจอร์ทำงานในรุ่นประเมิน, เงียบในการผลิต
ใบอนุญาต Temporary ที่ใช้งานอยู่ให้ทุกความสามารถ; ใบอนุญาตที่คุณซื้อให้เฉพาะสิ่งที่คุณซื้อ. หากไม่มีความสามารถ, ไฟล์ Search หรือ Annotation ของมันจะไม่ถูกสร้าง, และปลั๊กอินที่ลงทะเบียนจะหยุดไซต์ที่การเริ่มต้น. เปรียบเทียบ IsCapabilityGranted(...) กับทุกฟีเจอร์ที่คุณใช้ก่อนทำการปรับใช้.
การค้นหาไม่พบอะไร (หรือพบน้อยเกินไป)
- สำหรับ PDF,
AllowSearchไม่ได้เปิดใช้งานเมื่อเอกสารถูกเปิด — ค่าเริ่มต้นคือfalse. Word, Excel, และ PowerPoint มีสวิตช์เดียวกันนี้ - เนื้อหาเป็นการสแกนหรือเป็นภาพเท่านั้น ดังนั้นจึงไม่มีชั้นข้อความให้จับคู่
- HTML และ Microsoft Project (MPP) ไม่สามารถค้นหาได้ตามค่าเริ่มต้น: ตั้งค่า
DefaultRender = falseเพื่อให้พวกมันแสดงผลผ่านการฉาย PDF พร้อมข้อความ objViewer.CanSearch()เป็นfalseหลังจากการเริ่มต้น: รูปแบบที่แก้ไขแล้วไม่มีเส้นทางการค้นหา. สิ่งนี้แยกจากใบอนุญาต Search; ตรวจสอบทั้งสอง- หน้าอ่านค่าที่คืนจาก
objViewer.Search(...)— จำนวนจะมาถึงในอาร์กิวเมนต์ที่สามของมัน, ซึ่งเป็น callback
ยังติดอยู่หรือไม่?
ทำซ้ำปัญหาด้วยการตั้งค่าขั้นต่ำจาก เริ่มต้นอย่างรวดเร็ว. หากมันทำซ้ำได้ที่นั่น, ติดต่อฝ่ายสนับสนุนพร้อมเอกสาร, Global.asax.cs ของคุณ, ส่วน Doconut ของ Web.config, และรายการบันทึกเหตุการณ์ของ Windows หากมี.
หน้านี้เป็นประโยชน์หรือไม่?