1. IronOCR
  2. 문제 해결
  3. IronOCR와 64비트 아키텍처를 항상 사용하세요.

항상 IronOCR에 64비트 아키텍처 사용

Curtis Chau
Curtis Chau
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronOCR은 내부에서 메모리 집약적인 작업을 실행하므로, 32비트(x86) 빌드는 ~2GB 메모리 상한에 부딪혀 대량 또는 대용량 문서에서 실패하기 시작합니다. 64비트(x64)로 대상으로 설정이 해결책입니다.

32비트 프로세스는 기계의 RAM이 얼마나 많든 대략 2GB의 사용 가능한 메모리로 한정됩니다. 그 한계하에서, OCR 작업은 일반적으로 다음과 같이 표시됩니다:

System.OutOfMemoryException

동일한 상한의 다른 증상으로는 OCR 엔진 실행 중에 교착 상태 발생, 이미지 전처리에서 자원 고갈, 충돌 또는 처리되지 않은 예외, 시간초과하거나 조용히 실패하는 OCR 결과가 포함됩니다.

압박은 IronOCR이 문서를 통해 수행하는 작업에서 옵니다: 고해상도 이미지 렌더링, 임시 래스터화, 광학 문자 인식, 그리고 기계 학습 모델을 사용한 깊은 텍스트 추출 (AdvancedScan 메서드와 SearchablePDF 출력에서 사용됨). 이들 각각은 문서당 수백 메가바이트를 요구할 수 있으며, 다중 페이지 PDF, 다중 페이지 TIFF 및 300+ DPI 이미지는 이를 더 높입니다.

참고해 주세요IronOCR은 또한 OCR, 이미지 렌더링 및 PDF 래스터화를 위해 네이티브 라이브러리를 호출합니다. 이들은 .NET 가비지 수집기가 볼 수 없는 관리되지 않은 메모리를 할당하므로 32비트 프로세스에서 더 큰 압박을 추가합니다.

해결책

옵션 1: Visual Studio에서 플랫폼 대상 설정

빌드 설정을 통해 프로젝트를 x64로 전환하십시오:

  1. 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 속성을 엽니다.
  2. 빌드 탭을 엽니다.
  3. 플랫폼 대상을 x64로 설정합니다.
  4. 32비트 우선은 선택하지 않은 상태로 둡니다.

옵션 2: CLI 또는 .csproj에서 대상 설정

64비트 런타임에 대해 게시하여 빌드 시 아키텍처를 강제하십시오:

dotnet publish -c Release -r win-x64
dotnet publish -c Release -r win-x64
SHELL

또는 직접적으로 요소에 .csproj를 고정할 수 있습니다:

<PropertyGroup>
  <PlatformTarget>x64</PlatformTarget>
  <Prefer32Bit>false</Prefer32Bit>
</PropertyGroup>
<PropertyGroup>
  <PlatformTarget>x64</PlatformTarget>
  <Prefer32Bit>false</Prefer32Bit>
</PropertyGroup>
XML

<Prefer32Bit>false</Prefer32Bit> 라인은 프로젝트가 AnyCPU일 때 중요합니다: 이를 활성화하면 앱은 여전히 32비트 프로세스로 시작하며 동일한 상한을 상속받습니다.

경고"AnyCPU"를 "32비트 우선"으로 활성화하지 마십시오. 이는 64비트 기계에서도 조용히 2GB 제한을 재도입합니다.

아키텍처를 의심할 때

OCR 작업이 예상치 못하게 정지되거나 충돌할 때, 메모리 부족 예외가 간헐적으로 발생하거나 대용량 문서에서 성능 저하가 발생하더라도 아키텍처를 먼저 확인하십시오. x86에서 실행 중일 경우, 다른 조사를 시작하기 전에 x64로 전환하십시오.

프로덕션에서 몇 가지 습관을 유지하십시오:

  • 프로덕션을 위해 x64를 대상으로 설정하십시오: 대규모 OCR 작업에 지원되는 유일한 구성입니다.
  • x64에서 개발: x64에서의 테스트는 실제 메모리 동작을 반영하며 문제를 조기에 파악합니다.
  • 64비트 Docker 이미지를 빌드하십시오: 기본 이미지가 linux/amd64인지 확인하십시오.

동시 OCR 작업은 메모리를 빠르게 증가시킵니다. 작은 문서에서도, 멀티 스레드 또는 비동기 작업으로 인해 빠르게 올라갈 수 있습니다.

아키텍처를 변경할 수 없는 경우

x64가 옵션이 아닐 경우, 큰 문서를 작은 조각으로 나누고 낮은 해상도로 처리하십시오. 성능과 정확성의 트레이드오프를 예상하십시오. 32비트 프로젝트에 대한 안정적인 지원은 현재 조사 중입니다.

Curtis Chau
Curtis Chau
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 6,136,090 | 버전: 2026.7 방금 출시
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronOcr
샘플을 실행하세요 이미지가 검색 가능한 텍스트로 바뀌는 것을 확인해 보세요.