# 항상 IronOCR에 64비트 아키텍처 사용
IronOCR은 내부에서 메모리 집약적인 작업을 실행하므로, 32비트(x86) 빌드는 ~2GB 메모리 상한에 부딪혀 대량 또는 대용량 문서에서 실패하기 시작합니다. 64비트(x64)로 대상으로 설정이 해결책입니다.
32비트 프로세스는 기계의 RAM이 얼마나 많든 대략 2GB의 사용 가능한 메모리로 한정됩니다. 그 한계하에서, OCR 작업은 일반적으로 다음과 같이 표시됩니다:
```txt
System.OutOfMemoryException
```
동일한 상한의 다른 증상으로는 OCR 엔진 실행 중에 교착 상태 발생, 이미지 전처리에서 자원 고갈, 충돌 또는 처리되지 않은 예외, 시간초과하거나 조용히 실패하는 OCR 결과가 포함됩니다.
압박은 IronOCR이 문서를 통해 수행하는 작업에서 옵니다: 고해상도 이미지 렌더링, 임시 래스터화, 광학 문자 인식, 그리고 기계 학습 모델을 사용한 깊은 텍스트 추출 (`AdvancedScan` 메서드와 `SearchablePDF` 출력에서 사용됨). 이들 각각은 문서당 수백 메가바이트를 요구할 수 있으며, 다중 페이지 PDF, 다중 페이지 TIFF 및 300+ DPI 이미지는 이를 더 높입니다.
[[i:(IronOCR은 또한 OCR, 이미지 렌더링 및 PDF 래스터화를 위해 네이티브 라이브러리를 호출합니다. 이들은 .NET 가비지 수집기가 볼 수 없는 관리되지 않은 메모리를 할당하므로 32비트 프로세스에서 더 큰 압박을 추가합니다.)]]
## 해결책
### 옵션 1: Visual Studio에서 플랫폼 대상 설정
빌드 설정을 통해 프로젝트를 x64로 전환하십시오:
1. 프로젝트를 마우스 오른쪽 버튼으로 클릭하고 **속성**을 엽니다.
2. **빌드** 탭을 엽니다.
3. **플랫폼 대상**을 `x64`로 설정합니다.
4. **32비트 우선**은 선택하지 않은 상태로 둡니다.
### 옵션 2: CLI 또는 .csproj에서 대상 설정
64비트 런타임에 대해 게시하여 빌드 시 아키텍처를 강제하십시오:
```bash
dotnet publish -c Release -r win-x64
```
또는 직접적으로 요소에 `.csproj`를 고정할 수 있습니다:
```xml
<PropertyGroup>
<PlatformTarget>x64</PlatformTarget>
<Prefer32Bit>false</Prefer32Bit>
</PropertyGroup>
```
`<Prefer32Bit>false</Prefer32Bit>` 라인은 프로젝트가 `AnyCPU`일 때 중요합니다: 이를 활성화하면 앱은 여전히 32비트 프로세스로 시작하며 동일한 상한을 상속받습니다.
[[w:("AnyCPU"를 "32비트 우선"으로 활성화하지 마십시오. 이는 64비트 기계에서도 조용히 2GB 제한을 재도입합니다.)]]
## 아키텍처를 의심할 때
OCR 작업이 예상치 못하게 정지되거나 충돌할 때, 메모리 부족 예외가 간헐적으로 발생하거나 대용량 문서에서 성능 저하가 발생하더라도 아키텍처를 먼저 확인하십시오. x86에서 실행 중일 경우, 다른 조사를 시작하기 전에 x64로 전환하십시오.
프로덕션에서 몇 가지 습관을 유지하십시오:
- **프로덕션을 위해 x64를 대상으로 설정하십시오:** 대규모 OCR 작업에 지원되는 유일한 구성입니다.
- **x64에서 개발:** x64에서의 테스트는 실제 메모리 동작을 반영하며 문제를 조기에 파악합니다.
- **64비트 Docker 이미지를 빌드하십시오:** 기본 이미지가 `linux/amd64`인지 확인하십시오.
동시 OCR 작업은 메모리를 빠르게 증가시킵니다. 작은 문서에서도, 멀티 스레드 또는 비동기 작업으로 인해 빠르게 올라갈 수 있습니다.
## 아키텍처를 변경할 수 없는 경우
x64가 옵션이 아닐 경우, 큰 문서를 작은 조각으로 나누고 낮은 해상도로 처리하십시오. 성능과 정확성의 트레이드오프를 예상하십시오. 32비트 프로젝트에 대한 안정적인 지원은 현재 조사 중입니다.
IronOCR은 내부에서 메모리 집약적인 작업을 실행하므로, 32비트(x86) 빌드는 ~2GB 메모리 상한에 부딪혀 대량 또는 대용량 문서에서 실패하기 시작합니다. 64비트(x64)로 대상으로 설정이 해결책입니다.
32비트 프로세스는 기계의 RAM이 얼마나 많든 대략 2GB의 사용 가능한 메모리로 한정됩니다. 그 한계하에서, OCR 작업은 일반적으로 다음과 같이 표시됩니다:
System.OutOfMemoryException
System.OutOfMemoryException
Text
동일한 상한의 다른 증상으로는 OCR 엔진 실행 중에 교착 상태 발생, 이미지 전처리에서 자원 고갈, 충돌 또는 처리되지 않은 예외, 시간초과하거나 조용히 실패하는 OCR 결과가 포함됩니다.
압박은 IronOCR이 문서를 통해 수행하는 작업에서 옵니다: 고해상도 이미지 렌더링, 임시 래스터화, 광학 문자 인식, 그리고 기계 학습 모델을 사용한 깊은 텍스트 추출 (AdvancedScan 메서드와 SearchablePDF 출력에서 사용됨). 이들 각각은 문서당 수백 메가바이트를 요구할 수 있으며, 다중 페이지 PDF, 다중 페이지 TIFF 및 300+ DPI 이미지는 이를 더 높입니다.
참고해 주세요: IronOCR은 또한 OCR, 이미지 렌더링 및 PDF 래스터화를 위해 네이티브 라이브러리를 호출합니다. 이들은 .NET 가비지 수집기가 볼 수 없는 관리되지 않은 메모리를 할당하므로 32비트 프로세스에서 더 큰 압박을 추가합니다.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.
