IRONSOFTWAREHOME

LinuxでのPDFフォームのロード中のプロセス停止

Curtis Chau
Curtis Chau
Updated: 2026年6月29日

Linux(例えば、.NET 8 のDebian)では、インタラクティブなフォームフィールドを含む特定のPDFファイルを読み込むときに、OcrInput.LoadPdf() が無限にフリーズすることがあります。 呼び出しが返らず、プロセスが停滞します。

Process hangs at OcrInput.LoadPdf() and never proceeds.
Text

一部のPDFにはインタラクティブフォームレイヤーがトリガーになります。 同じファイルはWindowsでは正常にロードされ、他のフォームPDFはLinuxでも正常にロードされる可能性があるため、問題は一貫性がなく、運用環境に現れる前に検出しにくいです。

解決策

PDFをIronOCRに渡す前にフラット化してください。 フラット化は、インタラクティブフォームフィールドを静的ページコンテンツに変換し、停止を引き起こすインタラクティブレイヤーを取り除きます。

1. IronPDFでPDFをフラット化する

ソースファイルをロードし、フラット化して静的コピーを保存します:

using IronPdf;

var pdf = PdfDocument.FromFile("ocrpdfform.pdf");
pdf.Flatten();
pdf.SaveAs("flattened_ocrpdfform.pdf");
C#

Flatten() はインタラクティブなフォームフィールドを削除し、IronOCRが停止せずに開けるプレーンドキュメントを残します。

2. フラット化されたファイル上でOCRを実行する

平坦化されたコピーにLoadPdf()を向け、その後通常通りに読み取ります:

using var ocrInput = new OcrInput();
ocrInput.LoadPdf("flattened_ocrpdfform.pdf"); // No longer stuck

var ocr = new IronTesseract();
var result = ocr.Read(ocrInput);
Console.WriteLine(result.Text);
C#

停止を防ぐ以外にも、フラット化はプラットフォーム全体で一貫した動作を提供し、OCRが必要としないインタラクティブ要素を削減し、処理を高速化するためのファイルの複雑さを減少させます。

Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

...
詳しく読む

準備はできましたか?

Nuget Downloads 6,236,385バージョン:2026.9リリースされたばかり

あなたの無料30日間の試用キーをすぐに入手。
クレジットカードやアカウントの作成は不要です。
PDF用C# NuGetライブラリ
NuGetでインストール

バージョン: 2026.9

PM > Install-Package IronOcr
nuget.org/packages/IronOcr/
  1. ソリューションエクスプローラーで参照を右クリックし、NuGetパッケージを管理を選択
  2. 「参照」を選択して「IronOCR」を検索
  3. パッケージを選択してインストール
C# PDF DLL
DLLをダウンロード

バージョン: 2026.9

または、Windowsインストーラーをこちらからダウンロード。

  1. IronOCRをダウンロードして、ソリューションディレクトリ内の~/Libsなどの場所に解凍します
  2. Visual Studioソリューションエクスプローラーで、リファレンスを右クリックします。「参照」、「IronOCR.dll」を選択

$999からのライセンス

Key in blue circle

無料の30日間トライアルキーをすぐに入手してください。

Your trial license will be sent to your email address

制限なし。100% ロック解除済み。クレジットカード不要。

bullet_checkedクレジットカードやアカウントの作成は不要です。制限なし。100% ロック解除済み。クレジットカード不要。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
義務のない相談を受ける
下記のフォームを記入するか、sales@ironsoftware.comにメールしてください。
あなたの詳細は常に守秘されます。
世界中の数百万人のエンジニアから信頼されています。
ライセンスはより安く
あなたの無料30日間の試用キーをすぐに入手。
クレジットカードやアカウントの作成は不要です。