C#에서 OCR 디버깅 방법

Updated: 2026년 5월 9일

IronOCR는 소스에서 OCR 실패를 감지하고, 단어 및 문자 수준에서 인식 품질을 평가하며, 장기 실행 작업을 실시간으로 모니터링할 수 있게 합니다. 진단 파일 로깅, 유형 예외 계층 구조, 결과별 신뢰도 점수, 및 OcrProgress 이벤트 같은 내장 도구들은 프로덕션 파이프라인에서 이러한 워크플로우들을 지원합니다.

이 가이드에서는 진단 로깅 활성화, 유형별 예외 처리, 신뢰도 점수를 사용한 출력 유효성 검사, 실시간 작업 진행 상황 모니터링, 배치 파이프라인 오류 분리 등 각 기능에 대한 실제 작동 예제를 살펴봅니다.

빠른 시작: 전체 OCR 진단 로깅 활성화

첫 번째 Read 호출 전에 LogFilePath 및 LoggingMode을 Installation 클래스에 설정하십시오. Tesseract 초기화, 언어 팩 로딩 및 처리 세부 정보를 로그 파일에 기록하려면 두 가지 속성만 있으면 됩니다.

1Install IronOCR with NuGet Package Manager
PM > Install-Package IronOcr
```
Install-Package IronOcr
```

2다음 코드 조각을 복사하여 실행하세요.

IronOcr.Installation.LogFilePath = "ocr.log"; IronOcr.Installation.LoggingMode = IronOcr.Installation.LoggingModes.All;

IronOcr.Installation.LogFilePath = "ocr.log"; IronOcr.Installation.LoggingMode = IronOcr.Installation.LoggingModes.All;

3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

무료 체험판으로 오늘 프로젝트에서 IronOCR 사용 시작하기

최소 워크플로우(5단계)

OCR 디버깅용 C# 라이브러리를 다운로드하세요.
LogFilePath 쓰기 가능한 파일 경로로 설정하세요.
전체 진단 정보를 캡처하려면 LoggingMode All 로 설정하십시오.
OCR 작업을 실행하여 문제 재현
생성된 로그 파일을 검사하여 엔진 경고 및 처리 세부사항 확인

진단 로깅을 활성화하는 방법은 무엇인가요?

Installation 클래스는 세 가지 로깅 제어를 노출합니다. 어떤 Read 메서드를 호출하기 전에 이것들을 설정하십시오.

using IronOcr;

// Write logs to a specific file
Installation.LogFilePath = "logs/ocr_diagnostics.log";

// Enable all logging channels: file + debug output
Installation.LoggingMode = Installation.LoggingModes.All;

// Or pipe logs into your existing ILogger pipeline
Installation.CustomLogger = myLoggerInstance;

using IronOcr;

// Write logs to a specific file
Installation.LogFilePath = "logs/ocr_diagnostics.log";

// Enable all logging channels: file + debug output
Installation.LoggingMode = Installation.LoggingModes.All;

// Or pipe logs into your existing ILogger pipeline
Installation.CustomLogger = myLoggerInstance;

Imports IronOcr

' Write logs to a specific file
Installation.LogFilePath = "logs/ocr_diagnostics.log"

' Enable all logging channels: file + debug output
Installation.LoggingMode = Installation.LoggingModes.All

' Or pipe logs into your existing ILogger pipeline
Installation.CustomLogger = myLoggerInstance

Imports IronOcr

' Write logs to a specific file
Installation.LogFilePath = "logs/ocr_diagnostics.log"

' Enable all logging channels: file + debug output
Installation.LoggingMode = Installation.LoggingModes.All

' Or pipe logs into your existing ILogger pipeline
Installation.CustomLogger = myLoggerInstance

LoggingMode은 LoggingModes 열거형에서 플래그 값을 수락합니다:

표 1: 로깅 모드 옵션
방법	출력 대상	사용 사례
`None`	비활성화됨	외부 모니터링을 사용한 프로덕션
`Debug`	IDE 디버그 출력 창	로컬 개발
`File`	`LogFilePath`	서버 측 로그 수집
`All`	디버그 + 파일	전체 진단 캡처

CustomLogger 속성은 Microsoft.Extensions.Logging.ILogger 구현을 허용하여 OCR 진단을 Serilog, NLog, 또는 파이프라인의 다른 구조적 로깅 싱크로 전달할 수 있습니다. ClearLogFiles을 사용하여 실행 사이에 누적된 로그 데이터를 제거합니다.

로깅이 설정되었으므로 다음 단계는 IronOCR 발생할 수 있는 예외와 각 예외를 처리하는 방법을 이해하는 것입니다.

IronOCR 어떤 예외를 발생시키나요?

IronOCR는 IronOcr.Exceptions 네임스페이스 아래에 유형화된 예외를 정의합니다. 포괄적인 차단 대신 이러한 오류를 구체적으로 포착하면 각 오류 유형을 올바른 복구 경로로 연결할 수 있습니다.

표 2: IronOCR 예외 참조
예외	일반적인 원인	수정 방법
`IronOcrInputException`	손상되거나 지원되지 않는 이미지/PDF	`OcrInput`로 로딩하기 전에 파일을 검증하세요
`IronOcrProductException`	OCR 실행 중 내부 엔진 오류	로그를 활성화하고 로그 출력을 확인하고 최신 NuGet 버전으로 업데이트
`IronOcrDictionaryException`	누락되었거나 손상된 `.traineddata` 언어 파일	언어 팩 NuGet 다시 설치하거나 `LanguagePackDirectory` 설정하세요.
`IronOcrNativeException`	네이티브 C++ 상호 운용 실패	Visual C++ 재배포 가능 패키지를 설치하고 AVX 지원 확인
`IronOcrLicensingException`	누락되었거나 만료된 라이선스 키	`Read` 호출하기 전에 `LicenseKey` 설정하세요.
`LanguagePackException`	언어 팩을 예상 경로에서 찾을 수 없습니다	`LanguagePackDirectory`를 확인하거나 NuGet 언어 패키지를 재설치하세요
`IronOcrAssemblyVersionMismatchException`	부분 업데이트 후 어셈블리 버전이 일치하지 않음	NuGet 캐시를 지우고, 패키지를 복원하고, 모든 IronOCR 패키지가 일치하는지 확인하세요

다음 try-catch 블록을 사용하여 각 예외 유형을 개별적으로 처리하고, 조건부 로깅을 위해 예외 필터를 적용하십시오.

입력

LoadPdf을 통해 OcrInput에 로드된 IronOCR 솔루션에서 Acme Corporation으로의 단일 페이지 공급업체 송장입니다. 여기에는 네 가지 품목, 세금 및 총액이 포함되어 있어 각 예외 처리기가 현실적인 연습을 할 수 있을 만큼 충분한 텍스트 다양성을 제공합니다.

invoice_scan.pdf: 공급업체 송장(#INV-2024-7829)은 각 유형의 예외 처리기를 순차적으로 시연하는 데 사용됩니다.

using IronOcr;
using IronOcr.Exceptions;

var ocr = new IronTesseract();

try
{
    using var input = new OcrInput();
    input.LoadPdf("invoice_scan.pdf");

    OcrResult result = ocr.Read(input);
    Console.WriteLine($"Text: {result.Text}");
    Console.WriteLine($"Confidence: {result.Confidence:P1}");
}
catch (IronOcrInputException ex)
{
    // File could not be loaded — corrupt, locked, or unsupported format
    Console.Error.WriteLine($"Input error: {ex.Message}");
}
catch (IronOcrDictionaryException ex)
{
    // Language pack missing — common in containerized deployments
    Console.Error.WriteLine($"Language pack error: {ex.Message}");
}
catch (IronOcrNativeException ex) when (ex.Message.Contains("AVX"))
{
    // CPU does not support AVX instructions
    Console.Error.WriteLine($"Hardware incompatibility: {ex.Message}");
}
catch (IronOcrLicensingException)
{
    Console.Error.WriteLine("License key is missing or invalid.");
}
catch (IronOcrProductException ex)
{
    // Catch-all for other IronOCR engine errors
    Console.Error.WriteLine($"OCR engine error: {ex.Message}");
    Console.Error.WriteLine($"Stack trace: {ex.StackTrace}");
}

using IronOcr;
using IronOcr.Exceptions;

var ocr = new IronTesseract();

try
{
    using var input = new OcrInput();
    input.LoadPdf("invoice_scan.pdf");

    OcrResult result = ocr.Read(input);
    Console.WriteLine($"Text: {result.Text}");
    Console.WriteLine($"Confidence: {result.Confidence:P1}");
}
catch (IronOcrInputException ex)
{
    // File could not be loaded — corrupt, locked, or unsupported format
    Console.Error.WriteLine($"Input error: {ex.Message}");
}
catch (IronOcrDictionaryException ex)
{
    // Language pack missing — common in containerized deployments
    Console.Error.WriteLine($"Language pack error: {ex.Message}");
}
catch (IronOcrNativeException ex) when (ex.Message.Contains("AVX"))
{
    // CPU does not support AVX instructions
    Console.Error.WriteLine($"Hardware incompatibility: {ex.Message}");
}
catch (IronOcrLicensingException)
{
    Console.Error.WriteLine("License key is missing or invalid.");
}
catch (IronOcrProductException ex)
{
    // Catch-all for other IronOCR engine errors
    Console.Error.WriteLine($"OCR engine error: {ex.Message}");
    Console.Error.WriteLine($"Stack trace: {ex.StackTrace}");
}

Imports IronOcr
Imports IronOcr.Exceptions

Dim ocr = New IronTesseract()

Try
    Using input = New OcrInput()
        input.LoadPdf("invoice_scan.pdf")

        Dim result As OcrResult = ocr.Read(input)
        Console.WriteLine($"Text: {result.Text}")
        Console.WriteLine($"Confidence: {result.Confidence:P1}")
    End Using
Catch ex As IronOcrInputException
    ' File could not be loaded — corrupt, locked, or unsupported format
    Console.Error.WriteLine($"Input error: {ex.Message}")
Catch ex As IronOcrDictionaryException
    ' Language pack missing — common in containerized deployments
    Console.Error.WriteLine($"Language pack error: {ex.Message}")
Catch ex As IronOcrNativeException When ex.Message.Contains("AVX")
    ' CPU does not support AVX instructions
    Console.Error.WriteLine($"Hardware incompatibility: {ex.Message}")
Catch ex As IronOcrLicensingException
    Console.Error.WriteLine("License key is missing or invalid.")
Catch ex As IronOcrProductException
    ' Catch-all for other IronOCR engine errors
    Console.Error.WriteLine($"OCR engine error: {ex.Message}")
    Console.Error.WriteLine($"Stack trace: {ex.StackTrace}")
End Try

Imports IronOcr
Imports IronOcr.Exceptions

Dim ocr = New IronTesseract()

Try
    Using input = New OcrInput()
        input.LoadPdf("invoice_scan.pdf")

        Dim result As OcrResult = ocr.Read(input)
        Console.WriteLine($"Text: {result.Text}")
        Console.WriteLine($"Confidence: {result.Confidence:P1}")
    End Using
Catch ex As IronOcrInputException
    ' File could not be loaded — corrupt, locked, or unsupported format
    Console.Error.WriteLine($"Input error: {ex.Message}")
Catch ex As IronOcrDictionaryException
    ' Language pack missing — common in containerized deployments
    Console.Error.WriteLine($"Language pack error: {ex.Message}")
Catch ex As IronOcrNativeException When ex.Message.Contains("AVX")
    ' CPU does not support AVX instructions
    Console.Error.WriteLine($"Hardware incompatibility: {ex.Message}")
Catch ex As IronOcrLicensingException
    Console.Error.WriteLine("License key is missing or invalid.")
Catch ex As IronOcrProductException
    ' Catch-all for other IronOCR engine errors
    Console.Error.WriteLine($"OCR engine error: {ex.Message}")
    Console.Error.WriteLine($"Stack trace: {ex.StackTrace}")
End Try

산출

성공 결과

송장이 깔끔하게 로드되고 엔진은 문자 수와 신뢰도 점수를 반환합니다.

터미널 출력에는 invoice_scan.pdf 파일의 OCR 읽기가 성공적으로 완료되었으며, 문자 수와 신뢰도 점수가 표시됩니다.

출력 실패

캐치 블록을 가장 구체적인 것부터 가장 일반적인 것 순으로 정렬하세요. when 조항은 AVX 관련 오류를 필터링하며 관련 없는 네이티브 오류를 잡지 않습니다. 각 핸들러는 예외 메시지를 기록합니다. 포괄적인 블록은 사후 분석을 위해 스택 추적 정보도 캡처합니다.

올바른 예외를 포착하면 무언가 잘못되었다는 것을 알 수 있지만, 엔진이 성공적으로 작동했을 때 얼마나 잘 작동했는지는 알 수 없습니다. 이를 위해서는 신뢰도 점수를 사용하십시오.

신뢰도 점수를 사용하여 OCR 출력 결과를 검증하는 방법은 무엇인가요?

OcrResult의 각 인스턴스는 0과 1 사이의 값을 가졌으며 인식된 모든 문자에 걸쳐 엔진의 통계적 확신도를 나타내는 Confidence 속성을 노출합니다. 이 기능은 문서 , 페이지 ,단락 , 단어 ,문자 등 결과 계층 구조의 모든 수준에서 접근할 수 있습니다.

임계값 기반 게이트 패턴을 사용하여 품질이 낮은 결과가 하위 단계로 전파되는 것을 방지하십시오.

입력

LoadImage에 로드된 품목이 나열된 세열의 영수증과 바코드를 포함하는 상품 영수증입니다. 좁은 폭, 고정폭 글꼴, 흐릿한 인쇄체는 단어별 신뢰도 임계값을 측정하는 실용적인 스트레스 테스트 도구로 활용될 수 있습니다.

receipt.png: 수신확인 이미지에 대해 임계값 게이트 신뢰도 검증 및 단어별 정확성 분석을 보여주는 열 발열 영수증 스캔

using IronOcr;

var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage("receipt.png");

OcrResult result = ocr.Read(input);
double confidence = result.Confidence;

Console.WriteLine($"Overall confidence: {confidence:P1}");

// Threshold-gated decision
if (confidence >= 0.90)
{
    Console.WriteLine("ACCEPT — high confidence, processing result.");
    ProcessResult(result.Text);
}
else if (confidence >= 0.70)
{
    Console.WriteLine("FLAG — moderate confidence, queuing for review.");
    QueueForReview(result.Text, confidence);
}
else
{
    Console.WriteLine("REJECT — low confidence, logging for investigation.");
    LogRejection("receipt.png", confidence);
}

// Drill into per-page and per-word confidence for diagnostics
foreach (var page in result.Pages)
{
    Console.WriteLine($"  Page {page.PageNumber}: {page.Confidence:P1}");

    var lowConfidenceWords = page.Words
        .Where(w => w.Confidence < 0.70)
        .ToList();

    foreach (var word in lowConfidenceWords)
    {
        Console.WriteLine($"    Low-confidence word: \"{word.Text}\" ({word.Confidence:P1})");
    }
}

using IronOcr;

var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage("receipt.png");

OcrResult result = ocr.Read(input);
double confidence = result.Confidence;

Console.WriteLine($"Overall confidence: {confidence:P1}");

// Threshold-gated decision
if (confidence >= 0.90)
{
    Console.WriteLine("ACCEPT — high confidence, processing result.");
    ProcessResult(result.Text);
}
else if (confidence >= 0.70)
{
    Console.WriteLine("FLAG — moderate confidence, queuing for review.");
    QueueForReview(result.Text, confidence);
}
else
{
    Console.WriteLine("REJECT — low confidence, logging for investigation.");
    LogRejection("receipt.png", confidence);
}

// Drill into per-page and per-word confidence for diagnostics
foreach (var page in result.Pages)
{
    Console.WriteLine($"  Page {page.PageNumber}: {page.Confidence:P1}");

    var lowConfidenceWords = page.Words
        .Where(w => w.Confidence < 0.70)
        .ToList();

    foreach (var word in lowConfidenceWords)
    {
        Console.WriteLine($"    Low-confidence word: \"{word.Text}\" ({word.Confidence:P1})");
    }
}

Imports IronOcr

Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadImage("receipt.png")

    Dim result As OcrResult = ocr.Read(input)
    Dim confidence As Double = result.Confidence

    Console.WriteLine($"Overall confidence: {confidence:P1}")

    ' Threshold-gated decision
    If confidence >= 0.9 Then
        Console.WriteLine("ACCEPT — high confidence, processing result.")
        ProcessResult(result.Text)
    ElseIf confidence >= 0.7 Then
        Console.WriteLine("FLAG — moderate confidence, queuing for review.")
        QueueForReview(result.Text, confidence)
    Else
        Console.WriteLine("REJECT — low confidence, logging for investigation.")
        LogRejection("receipt.png", confidence)
    End If

    ' Drill into per-page and per-word confidence for diagnostics
    For Each page In result.Pages
        Console.WriteLine($"  Page {page.PageNumber}: {page.Confidence:P1}")

        Dim lowConfidenceWords = page.Words _
            .Where(Function(w) w.Confidence < 0.7) _
            .ToList()

        For Each word In lowConfidenceWords
            Console.WriteLine($"    Low-confidence word: ""{word.Text}"" ({word.Confidence:P1})")
        Next
    Next
End Using

Imports IronOcr

Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadImage("receipt.png")

    Dim result As OcrResult = ocr.Read(input)
    Dim confidence As Double = result.Confidence

    Console.WriteLine($"Overall confidence: {confidence:P1}")

    ' Threshold-gated decision
    If confidence >= 0.9 Then
        Console.WriteLine("ACCEPT — high confidence, processing result.")
        ProcessResult(result.Text)
    ElseIf confidence >= 0.7 Then
        Console.WriteLine("FLAG — moderate confidence, queuing for review.")
        QueueForReview(result.Text, confidence)
    Else
        Console.WriteLine("REJECT — low confidence, logging for investigation.")
        LogRejection("receipt.png", confidence)
    End If

    ' Drill into per-page and per-word confidence for diagnostics
    For Each page In result.Pages
        Console.WriteLine($"  Page {page.PageNumber}: {page.Confidence:P1}")

        Dim lowConfidenceWords = page.Words _
            .Where(Function(w) w.Confidence < 0.7) _
            .ToList()

        For Each word In lowConfidenceWords
            Console.WriteLine($"    Low-confidence word: ""{word.Text}"" ({word.Confidence:P1})")
        Next
    Next
End Using

산출

터미널 출력에는 영수증 이미지에 대한 신뢰도 점수, 승인/플래그/거부 결정, 그리고 단어별 낮은 신뢰도 항목에 대한 상세 분석 정보가 표시됩니다.

이 패턴은 OCR이 데이터 입력, 송장 처리 또는 준수 워크플로에 피드되는 파이프라인에서 필수적입니다. 단어 단위 분석을 통해 원본 이미지의 어느 부분이 화질 저하를 유발했는지 정확하게 파악할 수 있습니다. 그런 다음 이미지 품질 필터 나 방향 보정을 적용하고 다시 처리할 수 있습니다. 신뢰 점수에 대한 자세한 내용은 신뢰 수준 사용법을 참조하세요.

장기적인 업무에서는 자신감만으로는 충분하지 않습니다. 엔진이 여전히 진행 중인지 알 필요가 있으며, 이는 OcrProgress 이벤트가 도움이 됩니다.

OCR 진행 상황을 실시간으로 모니터링하려면 어떻게 해야 하나요?

다중 페이지 문서의 경우, 각 페이지 완료 후 IronTesseract에서 OcrProgress 이벤트가 발생합니다. OcrProgressEventArgs 객체는 진행률 퍼센트, 경과 시간, 전체 페이지 수 및 완료된 페이지를 노출합니다. 이 예시에서는 경영진 요약, 매출 분석 및 운영 지표를 포함하는 구조화된 비즈니스 문서인 3페이지 분량의 분기 보고서를 입력으로 사용합니다.

입력

LoadPdf에 로드된 3페이지 짜리 2024년 1분기 금융 보고서입니다. 1페이지는 KPI 지표를 포함한 요약 보고서를, 2페이지는 제품 라인 및 지역별 매출표를, 3페이지는 운영 처리량을 다룹니다. 각 페이지 유형별로 페이지 처리 시간이 다르며, 이는 진행 상황 콜백에서 확인할 수 있습니다.

quarterly_report.pdf: 2024년 1분기 재무 보고서(3페이지, 요약, 매출 분석, 운영 지표)로, 페이지별 실시간 OcrProgress 콜백을 시연하는 데 사용됩니다.

using IronOcr;

var ocr = new IronTesseract();

ocr.OcrProgress += (sender, e) =>
{
    Console.WriteLine(
        $"[OCR] {e.ProgressPercent}% complete | " +
        $"Page {e.PagesComplete}/{e.TotalPages} | " +
        $"Elapsed: {e.Duration.TotalSeconds:F1}s"
    );
};

using var input = new OcrInput();
input.LoadPdf("quarterly_report.pdf");

OcrResult result = ocr.Read(input);
Console.WriteLine($"Finished in {result.Pages.Count()} pages, confidence: {result.Confidence:P1}");

using IronOcr;

var ocr = new IronTesseract();

ocr.OcrProgress += (sender, e) =>
{
    Console.WriteLine(
        $"[OCR] {e.ProgressPercent}% complete | " +
        $"Page {e.PagesComplete}/{e.TotalPages} | " +
        $"Elapsed: {e.Duration.TotalSeconds:F1}s"
    );
};

using var input = new OcrInput();
input.LoadPdf("quarterly_report.pdf");

OcrResult result = ocr.Read(input);
Console.WriteLine($"Finished in {result.Pages.Count()} pages, confidence: {result.Confidence:P1}");

Imports IronOcr

Dim ocr As New IronTesseract()

AddHandler ocr.OcrProgress, Sub(sender, e)
    Console.WriteLine($"[OCR] {e.ProgressPercent}% complete | " &
                      $"Page {e.PagesComplete}/{e.TotalPages} | " &
                      $"Elapsed: {e.Duration.TotalSeconds:F1}s")
End Sub

Using input As New OcrInput()
    input.LoadPdf("quarterly_report.pdf")

    Dim result As OcrResult = ocr.Read(input)
    Console.WriteLine($"Finished in {result.Pages.Count()} pages, confidence: {result.Confidence:P1}")
End Using

Imports IronOcr

Dim ocr As New IronTesseract()

AddHandler ocr.OcrProgress, Sub(sender, e)
    Console.WriteLine($"[OCR] {e.ProgressPercent}% complete | " &
                      $"Page {e.PagesComplete}/{e.TotalPages} | " &
                      $"Elapsed: {e.Duration.TotalSeconds:F1}s")
End Sub

Using input As New OcrInput()
    input.LoadPdf("quarterly_report.pdf")

    Dim result As OcrResult = ocr.Read(input)
    Console.WriteLine($"Finished in {result.Pages.Count()} pages, confidence: {result.Confidence:P1}")
End Using

산출

터미널 출력에는 3페이지 PDF 파일의 페이지별 OcrProgress 이벤트 콜백, 완료율 및 경과 시간이 표시됩니다.

이 이벤트를 로깅 인프라에 연결하여 OCR 작업 지속 시간을 추적하고 중단을 감지하세요. 경과 시간이 임계값을 초과했는데도 진행률이 증가하지 않으면 파이프라인에서 해당 작업을 조사 대상으로 표시할 수 있습니다. 이는 단일 잘못된 페이지가 전체 작업을 정지시킬 수 있는 배치 PDF 처리에 특히 유용합니다.

진행 상황 모니터링은 실행 상태를 보여주지만, 파일 수준 오류가 발생하면 이를 격리하지 않을 경우 전체 배치 작업이 중단될 수 있습니다.

일괄 OCR 파이프라인에서 오류를 어떻게 처리해야 하나요?

실제 운영 환경에서는 단일 파일 오류로 인해 전체 배치 처리가 중단되어서는 안 됩니다. 파일별로 오류를 분리하고, 실패 상황을 맥락과 함께 기록하며, 마지막에 요약 보고서를 생성합니다. 예제는 송장, 구매 주문서, 서비스 계약을 포함하는 스캔 문서 폴더를 처리하며, 고의로 오류 경로를 트리거하도록 손상된 파일을 포함합니다. 대표적인 예시는 아래와 같습니다.

입력

Directory.GetFiles에 전달된 PDF 폴더 - 송장, 구매 주문서, 서비스 계약서 및 고의로 손상된 파일입니다. 아래 두 가지 대표 샘플은 파이프라인이 한 번 실행에서 처리하는 문서의 다양성을 보여줍니다.

batch-scan-01.pdf: Bright Horizon Ltd. 송장(INV-2024-001) - OCR 검사 성공.

batch-scan-02.pdf: TechSupply Inc. 구매 주문서(PO-2024-042) - 동일 실행에서 두 번째 문서 유형.

using IronOcr;
using IronOcr.Exceptions;

var ocr = new IronTesseract();
Installation.LogFilePath = "batch_debug.log";
Installation.LoggingMode = Installation.LoggingModes.File;

string[] files = Directory.GetFiles("scans/", "*.pdf");
int succeeded = 0, failed = 0;
double totalConfidence = 0;
var failures = new List<(string File, string Error)>();

foreach (string file in files)
{
    try
    {
        using var input = new OcrInput();
        input.LoadPdf(file);

        OcrResult result = ocr.Read(input);
        totalConfidence += result.Confidence;
        succeeded++;

        Console.WriteLine($"OK: {Path.GetFileName(file)} — {result.Confidence:P1}");
    }
    catch (IronOcrInputException ex)
    {
        failed++;
        failures.Add((file, $"Input error: {ex.Message}"));
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.Message}");
    }
    catch (IronOcrProductException ex)
    {
        failed++;
        failures.Add((file, $"Engine error: {ex.Message}"));
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.Message}");
    }
    catch (Exception ex)
    {
        failed++;
        failures.Add((file, $"Unexpected: {ex.Message}"));
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.GetType().Name}: {ex.Message}");
    }
}

// Summary report
Console.WriteLine($"\n--- Batch Summary ---");
Console.WriteLine($"Total: {files.Length} | Passed: {succeeded} | Failed: {failed}");
if (succeeded > 0)
    Console.WriteLine($"Average confidence: {totalConfidence / succeeded:P1}");

foreach (var (f, err) in failures)
    Console.WriteLine($"  {Path.GetFileName(f)}: {err}");

using IronOcr;
using IronOcr.Exceptions;

var ocr = new IronTesseract();
Installation.LogFilePath = "batch_debug.log";
Installation.LoggingMode = Installation.LoggingModes.File;

string[] files = Directory.GetFiles("scans/", "*.pdf");
int succeeded = 0, failed = 0;
double totalConfidence = 0;
var failures = new List<(string File, string Error)>();

foreach (string file in files)
{
    try
    {
        using var input = new OcrInput();
        input.LoadPdf(file);

        OcrResult result = ocr.Read(input);
        totalConfidence += result.Confidence;
        succeeded++;

        Console.WriteLine($"OK: {Path.GetFileName(file)} — {result.Confidence:P1}");
    }
    catch (IronOcrInputException ex)
    {
        failed++;
        failures.Add((file, $"Input error: {ex.Message}"));
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.Message}");
    }
    catch (IronOcrProductException ex)
    {
        failed++;
        failures.Add((file, $"Engine error: {ex.Message}"));
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.Message}");
    }
    catch (Exception ex)
    {
        failed++;
        failures.Add((file, $"Unexpected: {ex.Message}"));
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.GetType().Name}: {ex.Message}");
    }
}

// Summary report
Console.WriteLine($"\n--- Batch Summary ---");
Console.WriteLine($"Total: {files.Length} | Passed: {succeeded} | Failed: {failed}");
if (succeeded > 0)
    Console.WriteLine($"Average confidence: {totalConfidence / succeeded:P1}");

foreach (var (f, err) in failures)
    Console.WriteLine($"  {Path.GetFileName(f)}: {err}");

Imports IronOcr
Imports IronOcr.Exceptions

Dim ocr As New IronTesseract()
Installation.LogFilePath = "batch_debug.log"
Installation.LoggingMode = Installation.LoggingModes.File

Dim files As String() = Directory.GetFiles("scans/", "*.pdf")
Dim succeeded As Integer = 0, failed As Integer = 0
Dim totalConfidence As Double = 0
Dim failures As New List(Of (File As String, Error As String))()

For Each file As String In files
    Try
        Using input As New OcrInput()
            input.LoadPdf(file)

            Dim result As OcrResult = ocr.Read(input)
            totalConfidence += result.Confidence
            succeeded += 1

            Console.WriteLine($"OK: {Path.GetFileName(file)} — {result.Confidence:P1}")
        End Using
    Catch ex As IronOcrInputException
        failed += 1
        failures.Add((file, $"Input error: {ex.Message}"))
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.Message}")
    Catch ex As IronOcrProductException
        failed += 1
        failures.Add((file, $"Engine error: {ex.Message}"))
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.Message}")
    Catch ex As Exception
        failed += 1
        failures.Add((file, $"Unexpected: {ex.Message}"))
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.GetType().Name}: {ex.Message}")
    End Try
Next

' Summary report
Console.WriteLine(vbCrLf & "--- Batch Summary ---")
Console.WriteLine($"Total: {files.Length} | Passed: {succeeded} | Failed: {failed}")
If succeeded > 0 Then
    Console.WriteLine($"Average confidence: {totalConfidence / succeeded:P1}")
End If

For Each failure In failures
    Console.WriteLine($"  {Path.GetFileName(failure.File)}: {failure.Error}")
Next

Imports IronOcr
Imports IronOcr.Exceptions

Dim ocr As New IronTesseract()
Installation.LogFilePath = "batch_debug.log"
Installation.LoggingMode = Installation.LoggingModes.File

Dim files As String() = Directory.GetFiles("scans/", "*.pdf")
Dim succeeded As Integer = 0, failed As Integer = 0
Dim totalConfidence As Double = 0
Dim failures As New List(Of (File As String, Error As String))()

For Each file As String In files
    Try
        Using input As New OcrInput()
            input.LoadPdf(file)

            Dim result As OcrResult = ocr.Read(input)
            totalConfidence += result.Confidence
            succeeded += 1

            Console.WriteLine($"OK: {Path.GetFileName(file)} — {result.Confidence:P1}")
        End Using
    Catch ex As IronOcrInputException
        failed += 1
        failures.Add((file, $"Input error: {ex.Message}"))
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.Message}")
    Catch ex As IronOcrProductException
        failed += 1
        failures.Add((file, $"Engine error: {ex.Message}"))
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.Message}")
    Catch ex As Exception
        failed += 1
        failures.Add((file, $"Unexpected: {ex.Message}"))
        Console.Error.WriteLine($"FAIL: {Path.GetFileName(file)} — {ex.GetType().Name}: {ex.Message}")
    End Try
Next

' Summary report
Console.WriteLine(vbCrLf & "--- Batch Summary ---")
Console.WriteLine($"Total: {files.Length} | Passed: {succeeded} | Failed: {failed}")
If succeeded > 0 Then
    Console.WriteLine($"Average confidence: {totalConfidence / succeeded:P1}")
End If

For Each failure In failures
    Console.WriteLine($"  {Path.GetFileName(failure.File)}: {failure.Error}")
Next

산출

터미널 출력에는 파일별 문자 수, 신뢰도 점수, 손상된 PDF에서 발생한 오류 1개, 요약 정보가 포함된 배치 파이프라인 결과가 표시됩니다.

외부 예외 처리 블록은 공유 저장소의 네트워크 시간 초과, 권한 문제 또는 대용량 TIFF 파일의 메모리 부족 상황과 같은 예기치 않은 오류를 처리합니다. 각 오류는 파일 경로와 오류 메시지를 요약 보고서에 기록하며, 루프는 나머지 파일을 계속 처리합니다. batch_debug.log의 로그 파일은 내부 진단을 트리거하는 모든 파일에 대한 엔진 수준의 세부 정보를 캡처합니다.

서비스 또는 웹 응용 프로그램에서 블록 없는 실행을 위해, IronOCR은 ReadAsync를 지원하며, 동일한 try-catch 구조를 사용합니다.

파이프라인이 오류 없이 실행되었지만 추출된 텍스트가 여전히 잘못된 경우, 근본 원인은 거의 항상 코드보다는 이미지 품질에 있습니다. 이 문제를 해결하는 방법은 다음과 같습니다.

OCR 정확도 문제를 어떻게 해결하나요?

신뢰도 점수가 지속적으로 낮다면 문제는 OCR 엔진이 아니라 원본 이미지에 있습니다. IronOCR 이러한 문제를 해결하기 위한 전처리 도구를 제공합니다.

선명도, 노이즈 제거, 팽창, 침식 등의 이미지 품질 필터를 적용하여 텍스트 가독성을 향상시키세요.
방향 보정 기능을 사용하여 스캔한 문서의 기울기를 자동으로 보정하고 회전시키세요.
저해상도 이미지의 경우 처리 전에 DPI 설정을 조정하십시오.
복잡한 레이아웃에서 텍스트 영역을 감지하고 분리하기 위해 컴퓨터 비전 기술을 활용합니다. IronOCR 유틸리티를 사용하면 필터 조합을 시각적으로 테스트하고 최적의 C# 구성을 내보낼 수 있습니다.

배포 관련 문제의 경우, IronOCR Azure Functions , Docker 및 Linux , 그리고 일반적인 환경 설정 에 대한 전용 문제 해결 가이드를 제공합니다.

다음엔 어디로 가야 할까요?

이제 런타임 시 IronOCR 디버깅 방법을 이해했으니 다음을 살펴보세요.

OCR 결과 구조 및 메타데이터 (페이지, 블록, 단락, 단어, 좌표 등) 탐색
결과 계층 구조의 모든 단계에서 신뢰도 점수 이해하기
ReadAsync와 함께 비동기 및 멀티스레딩을 사용하여 높은 처리량 파이프라인을 구축
전체 속성 목록을 위한 전체 API 참조 탐색

프로덕션 사용을 위해, 워터마크 제거 및 전체 기능에 액세스하려면 라이센스 획득을 기억하세요.

자주 묻는 질문

C#에서 OCR을 디버깅할 때 흔히 발생하는 문제는 무엇인가요?

흔히 발생하는 문제로는 부정확한 OCR 결과, 낮은 신뢰도 점수, 예기치 않은 예외 등이 있습니다. IronOCR은 이러한 문제를 파악하고 해결하는 데 도움이 되는 로깅 및 신뢰도 점수 산출과 같은 도구를 제공합니다.

IronOCR은 C#에서 오류 처리를 어떻게 지원합니까?

IronOCR은 유형별 예외와 상세한 오류 메시지를 제공하여, C# 애플리케이션에서 OCR 작업을 수행하는 동안 오류를 효과적으로 이해하고 처리하는 데 도움을 줍니다.

IronOCR은 디버깅을 위해 어떤 로깅 기능을 제공합니까?

IronOCR에는 OCR 작업에 대한 상세 정보를 기록하여 OCR 프로세스를 추적하고 잠재적인 문제를 파악하는 데 도움이 되는 내장 로깅 기능이 포함되어 있습니다.

신뢰도 점수가 OCR 결과를 어떻게 개선할 수 있나요?

IronOCR의 신뢰도 점수 기능은 인식된 텍스트의 정확도를 판단하는 데 도움을 주며, 이를 통해 개발자는 신뢰도가 낮은 부분에 집중하여 OCR 결과를 개선할 수 있습니다.

IronOCR을 사용하여 OCR 작업의 진행 상황을 추적할 수 있나요?

네, IronOCR은 개발자가 OCR 작업의 상태와 소요 시간을 모니터링할 수 있는 진행 상황 추적 기능을 제공하여, 더 나은 리소스 관리와 성능 최적화를 지원합니다.

OCR 오류 처리를 위해 어떤 try-catch 패턴을 권장하나요?

IronOCR은 예외를 원활하게 처리하기 위해 실제 운영 환경에 적합한 try-catch 패턴을 사용할 것을 권장하며, 이를 통해 OCR 애플리케이션의 견고성과 유지 관리성을 보장합니다.

IronOCR의 내장 도구는 OCR 디버깅을 어떻게 향상시킬 수 있습니까?

로깅, 타입화된 예외, 신뢰도 점수 등 IronOCR의 도구들은 문제 식별 및 해결을 위한 포괄적인 지원을 제공하여 디버깅 프로세스를 향상시킵니다.

OCR 애플리케이션에서 오류 로깅이 중요한 이유는 무엇입니까?

오류 로깅은 OCR 처리 과정에서 발생한 문제를 파악할 수 있게 해주어, 개발자가 애플리케이션의 문제를 신속하게 진단하고 수정할 수 있도록 하므로 매우 중요합니다.

IronOCR 디버깅에서 타입 지정 예외는 어떤 역할을 합니까?

IronOCR의 타입 지정 예외는 구체적인 오류 정보를 제공하므로, 개발자가 문제의 본질을 쉽게 파악하고 디버깅 과정에서 적절한 해결책을 적용할 수 있게 해줍니다.

개발자는 IronOCR의 디버깅 기능을 통해 어떤 이점을 얻을 수 있습니까?

개발자는 IronOCR의 디버깅 기능을 활용하여 문제를 효율적으로 해결하고, 애플리케이션 안정성을 높이며, OCR 결과의 전반적인 품질을 개선할 수 있습니다.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...

더 읽어보기