IronOCR의 지원을 최적화하는 방법

Curtis Chau

Updated: 2026년 6월 29일

Download IronOCR

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # IronOCR의 지원을 최적화하는 방법 IronOCR이 제대로 작동하도록 시간을 내어 주셔서 감사합니다. IronOCR을 개선하기 위해 정기적으로 릴리스하는 엔지니어 팀이 있습니다. 업데이트는 자주 [NuGet](https://www.nuget.org/packages/IronOcr/)에 1~2개월마다 배포됩니다. 저희가 더 효과적으로 도와드릴 수 있도록, 고객님께서 겪고 계신 문제를 다음 유형 중 하나로 분류해 주셔야 합니다. ## 예외 및 버그 IronOCR과 관련하여 치명적인 오류가 발생하여 코드 사용을 중단하게 되면 저희가 알았으면 합니다! 버그 보고서가 명확할수록 더 빨리 해결될 것입니다. 문제를 격리하기 위해 [예외 및 버그 보고 페이지](https://ironsoftware.com/csharp/ocr/troubleshooting/engineering-request-ocr/)의 지침을 따라 보고해주세요. - [문제 해결 가이드 읽기](https://ironsoftware.com/csharp/ocr/troubleshooting/general-troubleshooting-ocr/) 및 [언어 팩 FAQ](https://ironsoftware.com/csharp/ocr/languages/)를 읽어보면 IronOCR의 일반적인 문제와 한계를 알 수 있습니다. - 다음의 알려진 문제 목록에 문제가 있다면, 솔루션이 이미 제공되어 있을 수도 있습니다: ## 알려진 배포 문제 해결책이 로컬에서는 작동하지만 다른 컴퓨터에 배포될 때 실패할 경우, 해당 플랫폼에 대한 지원을 개선하고 문제 발생한 컴퓨터의 세부 사항을 포함하는 [버그 보고서를 작성](https://ironsoftware.com/csharp/ocr/troubleshooting/engineering-request-ocr/)해주시면 감사하겠습니다. ### 윈도우 - _System.Exception: Tesseract을 초기화할 수 없습니다. The fallback logic failed. - **32비트** 및 **64비트** 런타임에 대해 [Visual C++ 런타임](https://ironsoftware.com/csharp/ocr/troubleshooting/tesseract-fallback-logic/)을 Windows에 설치해주세요. - _처리되지 않은 예외: System.Runtime.InteropServices.SEHException_ - 이는 Celeron 및 Atom 프로세서 지원에 대한 [알려진 제한사항입니다](https://ironsoftware.com/csharp/ocr/troubleshooting/sehexception-avx-support/). 예정된 수정이 진행 중입니다. ### Linux, Docker, 그리고 MacOS - _처리되지 않은 예외입니다. System.DllNotFoundException: 네이티브 라이브러리를 [ libgdiplus, libgdiplus.so ] 또는 [ libgdiplus, libgdiplus.dylib ] 중 어떤 이름에서도 찾거나 로드할 수 없습니다._ - 사용 중인 Linux 또는 MacOS 운영 체제에서 [System.Drawing.Common을 지원하기 위해 libgdiplus를 설치해야 할 수 있습니다](https://ironsoftware.com/csharp/ocr/troubleshooting/libgdiplus/). - _System.TypeInitializationException: 'Gdip'의 유형 초기화 프로그램이 예외를 발생시켰습니다._ - .NET 6의 Linux 및 Mac에 대한 특정 문제입니다. Microsoft System.Drawing.Common에 대한 지원을 [본인의 .NET 6 프로젝트에 추가](https://ironpdf.com/troubleshooting/system-drawing-common-ironpdf/)하거나 .NET Framework, Core 3.1, 또는 .NET 5를 사용할 수 있습니다. 이 제한이 개선될 때까지. ## Azure Functions v3 및 v4 - "OCRData 파일을 찾을 수 없음"에 대한 예외는 [Azure 기능 배포 가이드](https://ironsoftware.com/csharp/ocr/troubleshooting/azure-functions-deployment/)를 사용하여 해결할 수 있습니다. ## 라이선스 _가장 일반적인 질문은 라이선스 관련입니다:_ - [_IronOCR 라이선스를 얻는 방법_](https://help.ironsoftware.com/licensing/licensing/) 및 사용 사례에 적용되는 라이선스. - [_상업적 배포를 위한 라이선스 키 적용 방법_](https://ironsoftware.com/csharp/ocr/get-started/license-keys/)은 또한 매우 일반적인 기사입니다. _이것들이 문제 해결에 도움이 되지 않는 경우, 당사의 고도로 훈련된 엔지니어들에게 도움을 요청하시기 바랍니다. [_가장 신속한 해결을 위해 이 가이드를 따르십시오_](https://ironsoftware.com/csharp/ocr/troubleshooting/engineering-request-ocr/)._

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

IronOCR이 제대로 작동하도록 시간을 내어 주셔서 감사합니다. IronOCR을 개선하기 위해 정기적으로 릴리스하는 엔지니어 팀이 있습니다. 업데이트는 자주 NuGet에 1~2개월마다 배포됩니다.

저희가 더 효과적으로 도와드릴 수 있도록, 고객님께서 겪고 계신 문제를 다음 유형 중 하나로 분류해 주셔야 합니다.

예외 및 버그

IronOCR과 관련하여 치명적인 오류가 발생하여 코드 사용을 중단하게 되면 저희가 알았으면 합니다! 버그 보고서가 명확할수록 더 빨리 해결될 것입니다. 문제를 격리하기 위해 예외 및 버그 보고 페이지의 지침을 따라 보고해주세요.

• 문제 해결 가이드 읽기 및 언어 팩 FAQ를 읽어보면 IronOCR의 일반적인 문제와 한계를 알 수 있습니다.
• 다음의 알려진 문제 목록에 문제가 있다면, 솔루션이 이미 제공되어 있을 수도 있습니다:

알려진 배포 문제

해결책이 로컬에서는 작동하지만 다른 컴퓨터에 배포될 때 실패할 경우, 해당 플랫폼에 대한 지원을 개선하고 문제 발생한 컴퓨터의 세부 사항을 포함하는 버그 보고서를 작성해주시면 감사하겠습니다.

윈도우

• _System.Exception: Tesseract을 초기화할 수 없습니다. The fallback logic failed.
  • 32비트 및 64비트 런타임에 대해 Visual C++ 런타임을 Windows에 설치해주세요.
• 처리되지 않은 예외: System.Runtime.InteropServices.SEHException
  • 이는 Celeron 및 Atom 프로세서 지원에 대한 알려진 제한사항입니다. 예정된 수정이 진행 중입니다.

Linux, Docker, 그리고 MacOS

• 처리되지 않은 예외입니다. System.DllNotFoundException: 네이티브 라이브러리를 [ libgdiplus, libgdiplus.so ] 또는 [ libgdiplus, libgdiplus.dylib ] 중 어떤 이름에서도 찾거나 로드할 수 없습니다.
  • 사용 중인 Linux 또는 MacOS 운영 체제에서 System.Drawing.Common을 지원하기 위해 libgdiplus를 설치해야 할 수 있습니다.
• System.TypeInitializationException: 'Gdip'의 유형 초기화 프로그램이 예외를 발생시켰습니다.
  • .NET 6의 Linux 및 Mac에 대한 특정 문제입니다. Microsoft System.Drawing.Common에 대한 지원을 본인의 .NET 6 프로젝트에 추가하거나 .NET Framework, Core 3.1, 또는 .NET 5를 사용할 수 있습니다. 이 제한이 개선될 때까지.

Azure Functions v3 및 v4

• "OCRData 파일을 찾을 수 없음"에 대한 예외는 Azure 기능 배포 가이드를 사용하여 해결할 수 있습니다.

라이선스

가장 일반적인 질문은 라이선스 관련입니다:

• IronOCR 라이선스를 얻는 방법 및 사용 사례에 적용되는 라이선스.
• 상업적 배포를 위한 라이선스 키 적용 방법은 또한 매우 일반적인 기사입니다.

이것들이 문제 해결에 도움이 되지 않는 경우, 당사의 고도로 훈련된 엔지니어들에게 도움을 요청하시기 바랍니다. 가장 신속한 해결을 위해 이 가이드를 따르십시오.

Curtis Chau

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

기술 문서 작성자

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

...

더 읽어보기