Erro de Compatibilidade de Assembly Após Atualização de Versão no .NET Framework

Atualizado:junho 9, 2026

Translated

View the article in English

Após atualizar o IronPDF em um projeto do .NET Framework, a aplicação lança esta exceção em tempo de execução:

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)

A atualização do pacote NuGet instala novas versões de assembly, mas as versões antigas permanecem em cache no bin/Debug do projeto (ou bin/Release) e nos diretórios de saída runtimes. .NET Framework resolve assemblies a partir dessas pastas locais antes de consultar o cache do NuGet, portanto, os DLLs em cache e obsoletos conflitam com o pacote recentemente instalado e causam a falha de vinculação.

Solução

Passo 1: Desinstale o IronPDF e todos os pacotes relacionados ao Iron (como IronPdf.Slim, IronPdf.Native.Chrome.Windows) usando o Gerenciador de Pacotes NuGet no Visual Studio (Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes NuGet para Solução).

Passo 2: Exclua a pasta runtimes e a pasta bin/Debug (ou bin/Release) do diretório de saída do seu projeto.

Passo 3: Reinstale o IronPDF via Gerenciador de Pacotes NuGet.

Se a limpeza do Visual Studio for insuficiente, limpe o cache global do NuGet via linha de comando e force uma restauração limpa:

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

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

SHELL

Para implantações em servidor: remova todos os DLLs antigos do IronPDF do diretório do servidor antes de republicar. Implante em um novo diretório e atualize o IIS para apontar para o novo local em vez de sobrescrever arquivos no lugar.

Veja também: referência de erro de compatibilidade de versão de assembly do IronPDF e falha na implantação do pacote NuGet.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...