トラブルシューティング
一般的なエラーの診断
多くの 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" /> |
ブラウザコンソールは HEAD /DocImage.axd?...&page=1 に対して 404 を表示します | ハンドラが 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' |
| サイトが起動またはリサイクルされた後の最初のドキュメントは1分以上かかりますが、以降は高速です | ドキュメントエンジンは最初のオープン時にロードされ、リアルタイムのウイルス対策がロード時にスキャンします | サイトを事前にウォームアップし、プールを稼働させ続けます — 起動後の最初のドキュメント を参照 |
| 大きなアップロードで IIS エラーページが表示されます | アップロードが maxRequestLength (KB) または maxAllowedContentLength (バイト) を超えています | 両方とも最大ファイルまたはウィジェット上限を超えるように設定してください |
起動失敗
Application_Start でスローされた例外はブラウザに届きません:すべてのリクエストが空の 500 で応答し、IIS ログには有用な情報がありません。例外は Windows イベントログ(イベントビューア → Windows ログ → 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\ のすべてのアセンブリをロードします。そのため、bin\ に存在しないバージョンを指定した Web.config のバインディングリダイレクトはサイト全体を停止させます。手動で編集する代わりに、NuGet が生成したリダイレクト(SDK スタイルプロジェクトの場合は bin\<YourApp>.dll.config から)をコピーし、パッケージ更新後に再度コピーしてください。
このページの閲覧権限がありません。
要求された ASP.NET セッションがドキュメントの権限を取得していなかったため、ページが拒否されました。順に確認してください:
- オープンはセッション状態で実行されました。 MVC コントローラや Web Forms ページはこれを持っています。ドキュメントを開くカスタム
IHttpHandlerはSystem.Web.SessionState.IRequiresSessionStateを実装する必要があります。そうでなければセッションを付与できません。 - セッション状態が有効です。
<sessionState mode="Off" />はすべてのページを拒否します。 - クッキーがハンドラに届いています。 ウィジェットの同一オリジンリクエストは
ASP.NET_SessionIdを含みますが、スクリプトやサーバー間呼び出し、クッキーのないクロスオリジンページは含みません。 - Web ファーム: オープンはブラウザ (
DocOptions.BrowserId) にバインドし、ページはチケット (objViewer.View(token, access)) を渡します。すべてのノードが同じ署名キーを使用します。
拒否はステータス 200 で提供される画像で、約 2 KB です。ステータスコードだけをチェックするモニタはこれをページとしてカウントします。
ドキュメント セッションが見つかりません。ドキュメントを再度開いてください。
トークンが期限切れになった(スライディングウィンドウ、DocOptions.TimeOut、デフォルト 60 分)、ドキュメントが閉じられた、または単一サーバー上でアプリケーションプールがリサイクルされた可能性があります。リサイクルはスケジュール通り、すべての Web.config 編集時、そしてプールのアイドルタイムアウト(IIS のデフォルトは 20 分)後に発生します。新しいトークンのためにドキュメントを再度開いてください。
ドキュメントのオープンに失敗しました
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 では、ライセンスはサイトルート(AppContext.BaseDirectory\wwwroot)下の wwwroot に配置する必要があり、bin\ には置きません。IDoconutLicenseService を確認してください(License.IsLicenseFileFound、IsExpired、IsVersionValid、License.RejectionMessage)。
レガシードキュメントが文字化けします — 起動時にコードページエンコーディングを一度だけ登録してください:
// Global.asax.cs, Application_Start - DoconutHost.Initialize の前に。
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);フォントが間違っている、または置き換えられています — サーバーにドキュメントのフォントがありません。Office がインストールされていない Windows Server は開発マシンに比べてフォントが非常に少ないです。フォントをインストールするか、FontFolders(WordConfig と PptConfig 上)をフォントが格納されたフォルダーに指すよう設定してください。
画像アノテーションはビューアに表示されるが、エクスポート時に「Image blocked」ボックスが出ます — 画像のホストがプライベートまたはループバックアドレスであり、サーバーが取得を拒否しています。アノテーション
評価版では機能したが、本番環境では無音です
アクティブな一時ライセンスはすべての機能を許可します;購入したライセンスは購入した機能のみを許可します。機能がない場合、その検索やアノテーションファイルは出力されず、登録されたプラグインが起動時にサイトを停止させます。デプロイ前に使用するすべての機能と IsCapabilityGranted(...) を比較してください。
検索で何も見つからない(または少なすぎる)
- PDF の場合、
AllowSearchはドキュメントを開いたときに有効になっていませんでした — デフォルトはfalseです。Word、Excel、PowerPoint でも同じスイッチが公開されています。 - コンテンツがスキャンされたもの、または画像のみの場合、マッチさせるテキスト層がありません。
- HTML と Microsoft Project (MPP) はデフォルト設定では検索できません。
DefaultRender = falseを設定して、テキスト付きの PDF 投影でレンダリングさせてください。 objViewer.CanSearch()は初期化後にfalseです:解決された形式には検索パスがありません。これは Search ライセンスとは別ですので、両方を確認してください。- ページは
objViewer.Search(...)の戻り値を読み取ります — カウントは第3引数のコールバックで受け取られます。
まだ解決しないですか?
最小構成のセットアップで問題を再現してください(クイックスタート)。そこで再現した場合は、ドキュメント、Global.asax.cs、Doconut の Web.config 部分、そして可能であれば Windows イベントログのエントリを添えてサポートに連絡してください。
このページは役に立ちましたか?