程式集參考不匹配0x80131040問題探究-有解無憂

進行插件式編程的時候，經常性地彈出這么個東西找到的程式集清單定義與程式集參考不匹配， (例外來自 HRESULT:0x80131040)，往往這種問題特別難以解決，搞定了一個還要出另外一個，得研究一下怎么處理，

參考不匹配

這里提示需要加載一個4.2.0.0版本的dll，我先看看檔案夾下面有沒有對應的dll，查看檔案dll的詳細資訊，

這個版本號4.6.27818.1和4.2.0.0也差的有點太遠了吧，是這個問題？其實不是的，這個地方顯示的版本和程式集的版本不是一回事，

程式集版本

.NET程式有很多版本的說法，官方對這個有解釋，通過檔案管理器獲得的版本是AssemblyFileVersion，而程式集加載器定位的版本使用的是AssemblyVersion，這兩個東西完全不是一回事，通過右鍵，我們看不到AssemblyVersion，比較簡單的方式，可以通過Powershell腳本來查看程式集版本，

ls *.dll -r |
    ForEach-Object {
        try {
            $_ | Add-Member NoteProperty FileVersion ($_.VersionInfo.FileVersion)
            $_ | Add-Member NoteProperty AssemblyVersion (
                [Reflection.AssemblyName]::GetAssemblyName($_.FullName).Version
            )
        } catch {}
        $_
    } |
    Select-Object Name,FileVersion,AssemblyVersion

可以看到，我這邊的程式集是4.2.0.1版本的，不是4.2.0.0版本的，因此，程式集不能正常加載，

我自己的專案是使用nuget進行包管理的，參考的包的版本號是4.5.3（又多一個版本...），程式集版本是4.2.0.1，我找遍了整個專案，都沒有找到我dll專案中關于4.2.0.0版本的參考，苦思良久，打盹的時候忽然想起來，是不是那個exe的問題？

系結重定向

我的主exe程式是使用.NET Framework 4.6.1進行編譯，然后單獨編譯dll作為插件放入一個檔案夾，由exe程式進行加載，那有可能是exe參考了4.2.0.0這個版本，或者是其他dll插件參考了這個版本，造成版本不兼容，

這種情況可以有很多種解決方案，這篇文章寫的非常詳細，推薦讀一讀，而我這里使用了最簡單也是作者比較推薦的辦法，程式集參考的系結重定向，

使用這個方法有一個前提，你需要完全了解其他程式參考這個程式版本的時候不會出問題，一般小版本號的變動，是相對比較安全的，

一直以來，我寫.NET Framework程式貌似就很少有這種問題，是因為微軟會自動給程式設定重定向，我們可以通過在專案上右鍵，點選自動生成系結重定向，

之后，會出現一個app.config檔案，它會在生成程式的時候，變成程式名稱.dll.config的形式，里面大概是這個樣子的：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="System.Threading.Tasks.Extensions" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-4.2.0.1" newVersion="4.2.0.1" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

可以發現，這個東西對我們參考的版本內容進行了限制，強制某個范圍內的版本重定向為一個固定的版本號，不過，雖然dll中已經有這個內容，但是exe不會理會它的，它只會看自己主程式的.exe.config檔案，所以我們需要做的，就是把這一個部分內容搬到主程式的.exe.config中，

修改后重新運行，然后有又提示找不到System.Buffers.dll了，如法炮制，問題解決，

Fusion Log

有時候，通過這個方法找下去，處理完了，也不一定能夠解決，因為這個錯誤提示的是“未能加載檔案或程式集或它的某一個依賴項，”，也可能是某個參考的依賴項出了問題，這樣就不是很好找了，

好在.NET提供了一個程式集系結日志的工具，可以幫助我們查看系結的問題，一般情況下，這個東西是關閉的，系統會提示：

警告: 程式集系結日志記錄被關閉，
要啟用程式集系結失敗日志記錄，請將注冊表值 [HKLM\Software\Microsoft\Fusion!EnableLog] (DWORD)設定為 1，
注意: 會有一些與程式集系結失敗日志記錄關聯的性能損失，
要關閉此功能，請移除注冊表值 [HKLM\Software\Microsoft\Fusion!EnableLog]，

除錯的話，可以打開這個注冊表鍵值，或者簡單點，直接使用Fuslogvw.exe（程式集系結日志查看器），用管理員賬號啟動，在設定中設定好記錄的日志資訊，然后就可以記錄了，詳細的使用方法，見這里，就能看到詳細的資訊了，可以幫助我們深入分析內部系結的問題，（用完記得關，有性能損失，）

=== 預系結狀態資訊 ===
日志: DisplayName = System.Threading.Tasks.Extensions, Version=4.2.0.1, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
 (Fully-specified)
日志: Appbase = file:///C:/Temp/360zip$Temp/360$0/
日志: 初始 PrivatePath = NULL
呼叫程式集: DependencyWalker, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null，
===
日志: 此系結從 default 加載背景關系開始，
日志: 未找到應用程式組態檔，
日志: 使用主機組態檔: 
日志: 使用 C:\Windows\Microsoft.NET\Framework\v4.0.30319\config\machine.config 的計算機組態檔，
日志: 策略后參考: System.Threading.Tasks.Extensions, Version=4.2.0.1, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51
日志: 相同的系結已出現過，因 hr = 0x80070002 而失敗，

Dependency Walker

說到dll的參考，就有必要提一提非常有名的一個工具Dependency Walker，它可以查看PE檔案的參考情況，但是這個程式很久沒有更新了，對.NET很不友好，我找了一下，發現幾個替代：

Dependencies

這個工具可以認為是Dependency Walker的升級版，可以查看PE檔案的參考資訊，對.NET也可以支持，不過看的資訊太少了，也無法顯示缺失的情況，

DependencyWalker.Net

這個工具是專門為.NET設計的，可以查看程式集的參考情況，我洗掉了我插件的幾個dll，然后看就是這個樣子，一目了然，版本號也非常清楚，

通過這些工具，可以幫我們找一找到底是dll的問題，也許會對“試圖加載格式不正確的程式，”、“參考不匹配，”等參考相關問題有所幫助，

這些工具處理的大多是靜態參考，對于使用動態參考的，一般是不支持的，

總結

插件式編程極大增強了程式的拓展能力，不過，在處理程式集參考的時候，需要非常小心不同插件帶來的參考問題，程式設計的時候，可以使用不同檔案夾隔離不同的插件dll，并通過一些技巧來加載（可以查看之前的文章）和隔離，這樣，就可以避免出現不匹配的錯誤了，

參考資料

https://stackoverflow.com/questions/3267009/get-file-version-and-assembly-version-of-dll-files-in-the-current-directory-and

轉載請註明出處，本文鏈接：https://www.uj5u.com/net/237844.html

標籤：.NET技术

上一篇：Blazor wasm Host 專案遷移至.Net5(新手筆記)

下一篇：C#爬蟲，讓你不再覺得神秘