复盘一个诡异的Bug之FileNotFoundException

万万没想到，曾经随手改的一行依赖竟然导致程序无法发布为单文件，被这个问题困扰了一整天，好恨！！！

起因

在使用.NET8重构离线注册机并引入新版授权算法AddCode后，发布为单文件，运行后报错FileNotFoundException：

排查

这是个被全局捕获的未处理异常，在开发阶段从未出现，调试非单文件发布的可执行文件并没有问题，由此断定是单文件发布后引入的Bug。

从异常堆栈顶层开始排查，注释掉MainViewModel构造函数中引用到AddCode程序集中类的代码，运行后还是报错。对比提交历史后发现在XAML中依赖了AddCode程序集中的一个枚举：

<UserControl x:Class="Reg.Views.GenerateRegCode"……xmlns:addcode="clr-namespace:AddCode;assembly=AddCode"mc:Ignorable="d"d:DesignHeight="350" d:DesignWidth="520">……<TextBlock Text="激活方式" FontWeight="Bold" HorizontalAlignment="Left" Grid.Row="2" VerticalAlignment="Center"/><StackPanel Grid.Row="2" Grid.Column="1" VerticalAlignment="Center" Orientation="Horizontal"><RadioButton Content="离线激活" VerticalAlignment="Center" GroupName="ActiveWay" IsChecked="{Binding SelectedActiveWay,Converter={StaticResource activeWayConverter},ConverterParameter={x:Static addcode:LicenseWays.OfflineAuth}}" /><RadioButton Content="脱机激活" VerticalAlignment="Center" GroupName="ActiveWay" IsChecked="{Binding SelectedActiveWay,Converter={StaticResource activeWayConverter},ConverterParameter={x:Static addcode:LicenseWays.LocalAuth}}" Margin="20 0 0 0" /></StackPanel>……
</UserControl>

再次注释掉这段代码后，发布成单文件后就不抛异常了。

解决

问题点找着了，如何解决呢？

翻阅.NET文档中有关单文件发布的说明，除了用到反射的代码需要留意程序集路径外，没提到XAML中不能使用依赖程序集中定义的枚举，以往基于.NET5开发后发布为单文件的程序，都存在UI和后台均依赖第三方程序集的代码，从没出现过上述异常。

如此，一定是我的引用方式不对。

对比以往的项目后发现同样导入AddCode依赖，之前是这么写的

<ItemGroup>……<PackageReference Include="AddCode" Version="2.6.6" />……
</ItemGroup>

而本次出问题的项目中多了PrivateAssets和IncludeAssets：

<ItemGroup>……<PackageReference Include="AddCode" Version="3.1.1" PrivateAssets="All" IncludeAssets="All" />……
</ItemGroup>

去掉PrivateAssets和IncludeAssets后再次发布为单文件，运行起来一切正常。

反思

记不清什么时候改的依赖，目的大概是考虑到AddCode仅在本注册机内部使用，不想隐式传递依赖（也不可能会在其它项目中引用注册机）就顺手加上了，谁能想到这个无心之举给今日挖了一个如此大的坑。

至于为什么标记为PrivateAssets后发布为单文件在运行时会找不到程序集，我推测是作为私有资产的程序集AddCode不会被复制到输出目录，在编译后的产物中缺少该程序集。

为验证此猜想，我比较了标记为PrivateAssets前后可执行程序的大小，如下图所示：

可见未标记后运行正常的可执行程序大了45kb，而AddCode.dll大小为41kb，我的猜想应该没错。

Deepseek给的回答也验证了这一点。

2025年8月26日星期二・天霸