.NET Framework에서 버전 업그레이드 후 어셈블리 불일치

Curtis Chau

Updated: 2026년 6월 10일

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # .NET Framework에서 버전 업그레이드 후 어셈블리 불일치 .NET Framework 프로젝트에서 IronPDF를 업그레이드한 후 애플리케이션이 런타임에 이 예외를 발생시킵니다: ```txt System.IO.FileLoadException: Could not load file or assembly 'IronPdf, Version=X.Y.Z.W, Culture=neutral, PublicKeyToken=...' or one of its dependencies. The located assembly's manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040) ``` NuGet 패키지 업그레이드는 새로운 어셈블리 버전을 설치하지만, 오래된 버전은 프로젝트의 `bin/Debug` (또는 `bin/Release`) 및 `runtimes` 출력 디렉토리에 캐시된 상태로 남아 있습니다. .NET Framework는 NuGet 캐시를 참조하기 전에 이러한 로컬 폴더에서 어셈블리를 해석하므로 캐시에 남아 있는 DLL들이 새로 설치된 패키지와 충돌하여 바인딩 실패를 야기합니다. ## 해결책 **1단계:** Visual Studio의 NuGet 패키지 관리자(도구 > NuGet 패키지 관리자 > 솔루션에 대한 NuGet 패키지 관리)를 사용하여 IronPDF와 모든 Iron 관련 패키지(예: `IronPdf.Slim`, `IronPdf.Native.Chrome.Windows`)를 제거합니다. **2단계:** 프로젝트 출력 디렉토리에서 `runtimes` 폴더와 `bin/Debug` (또는 `bin/Release`) 폴더를 삭제합니다. **3단계:** NuGet 패키지 관리자를 통해 IronPDF를 다시 설치합니다. Visual Studio 정리가 충분하지 않다면, 명령 줄을 통해 전역 NuGet 캐시를 지우고 강제 복원을 수행하십시오: ```bash dotnet nuget locals all --clear dotnet restore --force ``` **서버 배포의 경우:** 재게시하기 전에 서버 디렉토리에서 모든 오래된 IronPDF DLL을 제거하십시오. 새 디렉토리에 배포하고 파일을 덮어쓰는 대신 IIS를 새 위치로 업데이트하십시오. 참조: [IronPDF 어셈블리 버전 불일치 예외 참조](https://ironpdf.com/troubleshooting/ironpdf-assembly-version-mismatch-exception/) 및 [NuGet 패키지 배포 실패](https://ironpdf.com/troubleshooting/failed-to-deploy-nuget-package/).

• ---

• 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

.NET Framework 프로젝트에서 IronPDF를 업그레이드한 후 애플리케이션이 런타임에 이 예외를 발생시킵니다:

System.IO.FileLoadException: Could not load file or assembly 'IronPdf, Version=X.Y.Z.W,
Culture=neutral, PublicKeyToken=...' or one of its dependencies. The located assembly's
manifest definition does not match the assembly reference.
(Exception from HRESULT: 0x80131040)

System.IO.FileLoadException: Could not load file or assembly 'IronPdf, Version=X.Y.Z.W,
Culture=neutral, PublicKeyToken=...' or one of its dependencies. The located assembly's
manifest definition does not match the assembly reference.
(Exception from HRESULT: 0x80131040)

NuGet 패키지 업그레이드는 새로운 어셈블리 버전을 설치하지만, 오래된 버전은 프로젝트의 bin/Debug (또는 bin/Release) 및 runtimes 출력 디렉토리에 캐시된 상태로 남아 있습니다. .NET Framework는 NuGet 캐시를 참조하기 전에 이러한 로컬 폴더에서 어셈블리를 해석하므로 캐시에 남아 있는 DLL들이 새로 설치된 패키지와 충돌하여 바인딩 실패를 야기합니다.

해결책

1단계: Visual Studio의 NuGet 패키지 관리자(도구 > NuGet 패키지 관리자 > 솔루션에 대한 NuGet 패키지 관리)를 사용하여 IronPDF와 모든 Iron 관련 패키지(예: IronPdf.Slim, IronPdf.Native.Chrome.Windows)를 제거합니다.

2단계: 프로젝트 출력 디렉토리에서 runtimes 폴더와 bin/Debug (또는 bin/Release) 폴더를 삭제합니다.

3단계: NuGet 패키지 관리자를 통해 IronPDF를 다시 설치합니다.

Visual Studio 정리가 충분하지 않다면, 명령 줄을 통해 전역 NuGet 캐시를 지우고 강제 복원을 수행하십시오:

dotnet nuget locals all --clear
dotnet restore --force

dotnet nuget locals all --clear
dotnet restore --force

서버 배포의 경우: 재게시하기 전에 서버 디렉토리에서 모든 오래된 IronPDF DLL을 제거하십시오. 새 디렉토리에 배포하고 파일을 덮어쓰는 대신 IIS를 새 위치로 업데이트하십시오.

참조: IronPDF 어셈블리 버전 불일치 예외 참조 및 NuGet 패키지 배포 실패.

Curtis Chau

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

기술 문서 작성자

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

...

더 읽어보기