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

업데이트됨:6월 9, 2026

Translated

View the article in English

.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)

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

SHELL

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

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

Curtis Chau

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

기술 문서 작성자

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

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

시작할 준비 되셨나요?

Nuget 다운로드 20,088,359 | 버전: 2026.7 방금 출시