1. IronOCR
  2. 故障排除
  3. IronOCR在處理大型PDF時，當EnglishFast為次要語言時會出現卡頓。

大型PDF文件的OCR在EnglishFast次要語言上卡住

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronOCR在處理大型PDF文件時，如果將OcrLanguage.EnglishFast新增為次要語言，可能會中途卡住。 沒有拋出異常，執行不會恢復，所以請求似乎永遠運行。

Execution stops at the ocr.Read() call. No exception is thrown and no error is logged.

當EnglishFast模型位於Windows的次要語言列表中時，會觸發卡住。 在我們的測試中，這個問題已在IronOCR 2026.7.2中重現。 在修正版本發布之前，請將該範圍內的任何版本視為可能受影響。 調整EnglishFast相對於其他次要語言的順序無濟於事。

解決方案

1. 查找次要語言配置

查找任何在您的OCR設置中傳遞AddSecondaryLanguage調用。

// This line causes the hang on large PDFs
ocr.AddSecondaryLanguage(OcrLanguage.EnglishFast);
// This line causes the hang on large PDFs
ocr.AddSecondaryLanguage(OcrLanguage.EnglishFast);
' This line causes the hang on large PDFs
ocr.AddSecondaryLanguage(OcrLanguage.EnglishFast)
$vbLabelText   $csharpLabel

2. 移除EnglishFast並保留English為主要語言

刪除或註釋掉造成問題的調用。 將OcrLanguage.English設置為主要語言，以保留英文識別質量，並將其他次要語言保持不變，它們不受影響。

// ocr.AddSecondaryLanguage(OcrLanguage.EnglishFast);
var ocr = new IronTesseract
{
    Language = OcrLanguage.English
};
ocr.AddSecondaryLanguage(OcrLanguage.Hindi);
ocr.AddSecondaryLanguage(OcrLanguage.Marathi);
// ocr.AddSecondaryLanguage(OcrLanguage.EnglishFast);
var ocr = new IronTesseract
{
    Language = OcrLanguage.English
};
ocr.AddSecondaryLanguage(OcrLanguage.Hindi);
ocr.AddSecondaryLanguage(OcrLanguage.Marathi);
Imports IronOcr

Dim ocr As New IronTesseract With {
    .Language = OcrLanguage.English
}
ocr.AddSecondaryLanguage(OcrLanguage.Hindi)
ocr.AddSecondaryLanguage(OcrLanguage.Marathi)
$vbLabelText   $csharpLabel

刪除OcrLanguage.English作為主要語言可以保持對含有大量英文文字的文件的覆蓋。

3. 重新運行受影響的PDF

再次處理文件。 現在應該能夠完成所有頁面而不會卡住。

警告卡住不會產生異常也不會有日誌條目。 執行只是在ocr.Read()處停止，所以卡住的請求是唯一需要注意的症狀。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 6,175,195 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在滾動？

想要快速證明？ PM > Install-Package IronOcr
執行範例 觀看您的圖像轉變為可搜尋文字。