Xử lý sự cố
Chẩn đoán các lỗi thường gặp
Nhiều lỗi System.Web không ném ra ngoại lệ nào bạn có thể thấy: trang trả về một 500 trống, một biểu tượng trả về 404, hoặc một yêu cầu không bao giờ trả về. Trang này được tổ chức dựa trên những gì bạn quan sát. Các thông báo được trích dẫn là văn bản nguyên bản mà Doconut tạo ra.
Các triệu chứng nhanh chóng
| Bạn thấy gì | Nguyên nhân có khả năng nhất | Cách khắc phục |
|---|---|---|
Mỗi yêu cầu trả về một 500 trống | Một ngoại lệ trong Application_Start: plugin không có giấy phép, tùy chọn không hợp lệ, cấu hình farm không đầy đủ — hoặc một binding redirect chỉ định phiên bản không có trong bin\ | Nhật ký sự kiện Windows, Application, nguồn ASP.NET. Xem Lỗi khởi động |
Một số trang MVC trả về một 500 trống | Razor biên dịch các view tại thời gian chạy: facade netstandard thiếu trong <compilation>, hoặc view sử dụng C# mới hơn 5 (?., $"...", nameof) | Thêm facade (Cài đặt); chuyển logic từ view sang controller |
Các trang hiển thị —, … hoặc tương tự thay vì dấu gạch ngang và dấu phụ | Các tệp trang không có byte-order mark được đọc bằng trang mã ANSI của máy chủ | <globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8" /> |
Console trình duyệt hiển thị 404 cho HEAD /DocImage.axd?...&page=1 | Handler được đăng ký mà không có động từ HEAD | verb="GET,HEAD,POST" trên handler |
| Tài liệu được hiển thị, nhưng các biểu tượng thanh công cụ và vòng quay tải bị thiếu | ResPath trỏ tới gốc tài nguyên, hoặc bắt đầu bằng / | ResPath: 'doconut-res/images' |
Các yêu cầu /doconut-res/... trả về 404 | Mô-đun tài nguyên không được đăng ký, runAllManagedModulesForAllRequests bị tắt, hoặc routing MVC bắt đường dẫn | Mục <modules>, và routes.IgnoreRoute("doconut-res/{*pathInfo}") |
Trình xem báo cáo The viewer handler could not be reached (no response). | BasePath bắt đầu bằng / ('/myapp' trở thành //myapp/…, máy chủ khác) | BasePath: '/' ở gốc site; 'myapp' trong thư mục ảo |
Trình xem báo cáo Please make sure your middleware is configured. | DocImage.axd trả lời 404: handler không có trong Web.config, routing MVC bắt nó, hoặc BasePath trỏ tới nơi khác | Mục <handlers>, routes.IgnoreRoute("{resource}.axd/{*pathInfo}"), và BasePath |
Mỗi trang hiển thị You Are Not Authorized To View This Page. | Tài liệu được mở trong yêu cầu không có session state, session state bị tắt, hoặc cookie session không tới DocImage.axd | Xem Không được phép |
| Quá trình chuyển đổi Web Forms không bao giờ trả về | Trang bị chặn ở ConvertAsync — một deadlock | Async="true" + RegisterAsyncTask (Plugin Chuyển đổi) |
| Mỗi trang có một watermark đánh giá | Không tìm thấy giấy phép — nó không có trong <site root>\wwwroot | Cài đặt giấy phép |
Một widget tải, nhưng hành động đầu tiên trả về 404 | Widget không được bật, hoặc basePath của nó không phải là '/DocImage.axd' | options.Add…Widget(), và basePath: '/DocImage.axd' |
| Tài liệu đầu tiên sau khi site khởi động hoặc tái tạo mất một phút hoặc hơn; các tài liệu sau nhanh hơn | Các engine tài liệu được tải khi mở lần đầu, và phần mềm diệt virus thời gian thực quét chúng khi tải | Khởi động site trước và giữ pool chạy — xem Tài liệu đầu tiên sau khi khởi động |
| Tải lên lớn hiển thị trang lỗi IIS | Tải lên vượt quá maxRequestLength (KB) hoặc maxAllowedContentLength (bytes) | Tăng cả hai lên trên giới hạn tệp hoặc widget lớn nhất của bạn |
Lỗi khởi động
Một ngoại lệ được ném trong Application_Start không tới trình duyệt: mọi yêu cầu trả về một 500 trống, và log IIS không hiển thị gì hữu ích. Ngoại lệ nằm trong Nhật ký sự kiện Windows (Event Viewer → Windows Logs → Application, nguồn ASP.NET). Những trường hợp thường gặp:
Plugin không có giấy phép:
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 của plugin phải nằm trong wwwroot, bên cạnh Doconut.Viewer.lic. Thiếu giấy phép và tệp legacy TRIAL không cung cấp khả năng cho plugin.
Tùy chọn không hợp lệ:
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.Một assembly không thể tải. ASP.NET tải mọi assembly trong bin\ khi ứng dụng khởi động, vì vậy một binding redirect trong Web.config chỉ định phiên bản thiếu trong bin\ sẽ dừng toàn bộ site. Sao chép các redirect do NuGet tạo (đối với dự án kiểu SDK, từ bin\<YourApp>.dll.config) thay vì chỉnh sửa thủ công, và sao chép lại sau khi cập nhật gói.
Bạn không được phép xem trang này.
Trang bị từ chối vì phiên ASP.NET yêu cầu chưa bao giờ được cấp tài liệu. Kiểm tra theo thứ tự:
- Quá trình mở đã chạy với trạng thái phiên. MVC controllers và Web Forms pages có nó. Một
IHttpHandlertùy chỉnh mở tài liệu phải triển khaiSystem.Web.SessionState.IRequiresSessionState, nếu không nó sẽ không có phiên để cấp. - Trạng thái phiên đang bật.
<sessionState mode="Off" />từ chối mọi trang. - Cookie đến được trình xử lý. Các yêu cầu cùng nguồn gốc của widget mang
ASP.NET_SessionId; một script, một cuộc gọi server-to-server, hoặc một trang cross-origin không có cookie thì không. - Web farm: quá trình mở ràng buộc trình duyệt (
DocOptions.BrowserId) và trang truyền vé (objViewer.View(token, access)); mọi nút đều sử dụng cùng một khóa ký.
Sự từ chối là một hình ảnh được phục vụ với trạng thái 200, khoảng 2 KB. Một công cụ giám sát chỉ kiểm tra mã trạng thái sẽ tính nó là một trang.
Không tìm thấy phiên tài liệu. Vui lòng mở lại tài liệu.
Mã thông báo đã hết hạn (cửa sổ trượt, DocOptions.TimeOut, mặc định 60 phút), tài liệu đã bị đóng, hoặc — trên một máy chủ đơn — pool ứng dụng đã được tái tạo. Việc tái tạo xảy ra theo lịch, vào mỗi lần chỉnh sửa Web.config, và sau thời gian chờ không hoạt động của pool (20 phút theo mặc định trong IIS). Mở lại tài liệu để nhận mã mới.
Mở tài liệu thất bại
LicenseException với lý do từ chối — tệp giấy phép đã được tìm thấy nhưng bị từ chối (chữ ký không hợp lệ, bị giả mạo, bị đưa vào danh sách đen, hoặc bản dựng nằm ngoài cửa sổ phiên bản của giấy phép). Việc mở bị chặn thay vì được gắn watermark.
LicenseException:
This document type requires the 'Dicom' plugin license.Tiện ích mở rộng chỉ được xử lý bởi một plugin (ở đây là DICOM). Plugin đã được đăng ký, nhưng không còn giấy phép nào cấp khả năng cho nó — thường là một giấy phép Temporary đã hết hạn sau khi trang web khởi chạy. Cài đặt một giấy phép để cấp quyền cho nó.
FormatNotSupportedException — không có trình xem (có sẵn, plugin, hoặc tùy chỉnh) nào khai báo tiện ích mở rộng này. DoconutOptions.RegisterViewer có thể thêm một trình xem cho các định dạng của bạn.
InvalidDataException — nội dung bị hỏng hoặc không khớp với tiện ích mở rộng (tệp đã được đổi tên). Xác thực các tệp tải lên trước khi mở.
InvalidOperationException:
No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().DocumentConverter đã được giải quyết mà không cần đăng ký plugin Converter.
Kết quả hiển thị sai
Các trang có watermark — không tìm thấy giấy phép, hoặc giấy phép Temporary đã hết hạn. Trong một giấy phép Temporary đang hoạt động, chỉ đầu ra của plugin mới có watermark. Giấy phép không bao phủ phiên bản này sẽ không có watermark: việc mở sẽ ném LicenseException. Trong IIS, giấy phép phải nằm trong wwwroot dưới thư mục gốc của site (AppContext.BaseDirectory\wwwroot), không phải trong bin\. Kiểm tra IDoconutLicenseService (License.IsLicenseFileFound, IsExpired, IsVersionValid, License.RejectionMessage).
Các tài liệu Legacy hiển thị văn bản rối — đăng ký các mã trang ký tự một lần, khi khởi động:
// Global.asax.cs, Application_Start - trước DoconutHost.Initialize.
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);Phông chữ sai hoặc được thay thế — máy chủ thiếu phông chữ của tài liệu. Một Windows Server không có Office có ít phông chữ hơn nhiều so với máy phát triển. Cài đặt các phông chữ, hoặc chỉ định FontFolders (trên WordConfig và PptConfig) tới một thư mục chứa chúng.
Một chú thích hình ảnh hiển thị trong trình xem nhưng khi xuất ra lại có hộp "Image blocked" — máy chủ chứa hình ảnh có địa chỉ riêng hoặc loopback, khiến server từ chối lấy. Xem Chú thích.
Tính năng hoạt động trong đánh giá, im lặng trong môi trường sản xuất
Một giấy phép Temporary đang hoạt động cấp mọi khả năng; giấy phép bạn mua chỉ cấp những gì bạn đã mua. Nếu thiếu khả năng, các tệp Search hoặc Annotation của nó sẽ không được tạo, và một plugin đã đăng ký sẽ dừng site khi khởi động. So sánh IsCapabilityGranted(...) với mọi tính năng bạn sử dụng trước khi triển khai.
Tìm kiếm không tìm thấy gì (hoặc quá ít)
- Đối với PDF,
AllowSearchkhông được bật khi tài liệu được mở — mặc định làfalse. Word, Excel và PowerPoint cũng có cùng công tắc này. - Nội dung được quét hoặc chỉ là hình ảnh, vì vậy không có lớp văn bản nào để khớp.
- HTML và Microsoft Project (MPP) không thể tìm kiếm ở chế độ mặc định: hãy đặt
DefaultRender = falseđể chúng hiển thị qua một phép chiếu PDF có văn bản. objViewer.CanSearch()làfalsesau khi khởi tạo: định dạng đã giải quyết không có đường dẫn tìm kiếm. Điều này tách biệt khỏi giấy phép Search; hãy kiểm tra cả hai.- Trang đọc giá trị trả về của
objViewer.Search(...)— số lượng được truyền vào đối số thứ ba, một callback.
Vẫn gặp khó khăn?
Tái hiện vấn đề bằng cấu hình tối thiểu từ Bắt đầu nhanh. Nếu nó tái hiện ở đó, hãy liên hệ hỗ trợ kèm theo tài liệu, Global.asax.cs của bạn, các phần Doconut của Web.config, và mục nhập nhật ký sự kiện Windows nếu có.
Trang này có hữu ích không?