عیبیابی
تشخیص خطاهای رایج
بسیاری از خطاهای System.Web بدون استثنایی که بتوانید ببینید رخ میدهند: صفحه یک 500 خالی برمیگرداند، یک آیکون 404 میشود، یا درخواست هرگز باز نمیگردد. این صفحه بر اساس آنچه مشاهده میکنید سازماندهی شده است. پیامهای نقلقولشده متن دقیق Doconut هستند.
علائم در یک نگاه
| چه میبینید | دلیل محتمل | راهحل |
|---|---|---|
هر درخواست یک 500 خالی برمیگرداند | یک استثنا در Application_Start: افزونهای بدون لایسنس، گزینه نامعتبر، پیکربندی ناقص farm — یا یک بازنویسی بایندینگ که نسخهای را نام میبرد که در bin\ وجود ندارد | لاگ رویداد ویندوز، 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 چیزی مفید نشان نمیدهد. استثنا در لاگ رویداد ویندوز (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 و صفحات Web Forms آن را دارند. یک
IHttpHandlerسفارشی که اسناد را باز میکند بایدSystem.Web.SessionState.IRequiresSessionStateرا پیادهسازی کند، در غیر این صورت نشست برای اعطا ندارد. - وضعیت نشست فعال است.
<sessionState mode="Off" />هر صفحهای را رد میکند. - کوکی به هندلر میرسد. درخواستهای هممنشئ ویجت،
ASP.NET_SessionIdرا حمل میکنند؛ اسکریپت، تماس سرور به سرور، یا صفحهای با منبع متفاوت بدون کوکی این کار را نمیکند. - مزرعه وب: باز کردن مرورگر را (
DocOptions.BrowserId) باند میکند و صفحه بلیت را (objViewer.View(token, access)) عبور میدهد؛ هر گره از همان کلید امضا استفاده میکند.
رد شدن یک تصویر است که با وضعیت 200 سرو میشود، حدود ۲ کیلوبایت. مانیتوری که فقط کدهای وضعیت را بررسی میکند، آن را به عنوان یک صفحه حساب میکند.
نشست سند یافت نشد. لطفاً سند را دوباره باز کنید.
توکن منقضی شد (پنجره لغزان، DocOptions.TimeOut، بهطور پیشفرض ۶۰ دقیقه)، سند بسته شد، یا — در یک سرور واحد — استخر برنامه بازنشانی شد. بازنشانی بر اساس برنامه زمانبندی میشود، در هر ویرایش Web.config، و پس از زمانسنجی بیکاری استخر (بهطور پیشفرض ۲۰ دقیقه در IIS). سند را دوباره باز کنید تا توکن جدید دریافت کنید.
باز کردن سند ناموفق است
LicenseException with a rejection reason — فایل لایسنس یافت شد اما رد شد (امضای نامعتبر، دستکاری، فهرست سیاه، یا ساختی خارج از بازه نسخه لایسنس). باز کردن به جای واترمارک مسدود میشود.
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 بدون ثبت افزونه Converter حل شد.
خروجی بهنظر نادرست میآید
صفحات دارای واترمارک هستند — لایسنی یافت نشد، یا لایسنس موقت منقضی شده است. در زیر یک لایسنس موقت فعال، فقط خروجی افزونه واترمارک میشود. لایسنس که این نسخه را پوشش نمیدهد واترمارک نمیشود: باز کردن خطای 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) به پوشهای که آنها را دارد اشاره دهید.
یک حاشیهنویسی تصویر در نمایشگر نشان داده میشود اما خروجی دارای جعبه «Image blocked» است — میزبان تصویر دارای آدرس خصوصی یا لوپبک است که سرور از دریافت آن خودداری میکند. ببینید Annotations.
ویژگی در ارزیابی کار میکرد، در تولید خاموش است
یک لایسنس موقت فعال تمام قابلیتها را اعطا میکند؛ لایسنس خریداری شده شما فقط آنچه را خریداری کردهاید اعطا میکند. بدون یک قابلیت، فایلهای جستجو یا حاشیهنویسی آن صادر نمیشوند، و یک افزونه ثبتشده سایت را در زمان راهاندازی متوقف میکند. قبل از استقرار، 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، و ورودی لاگ رویداد ویندوز اگر موجود است.
آیا این صفحه مفید بود؟