复盘一个诡异的Bug之FileNotFoundException

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

起因

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

排查

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

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

xaml 复制代码
<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依赖,之前是这么写的

xml 复制代码
<ItemGroup>
  ......
  <PackageReference Include="AddCode" Version="2.6.6" />
  ......
</ItemGroup>

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

xml 复制代码
<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日星期二・天霸

相关推荐
Jeff-Tsai21 分钟前
Day 25:审计轨迹与变更的前后值
.net·架构设计·erp·definition-driven
IT规划师4 小时前
Redis 核心机制 | 事务:执行序列的原子性、乐观锁与 8.x 条件写
redis·.net
Jeff-Tsai1 天前
Day 24:权限的三轴:动作、行与列
.net·架构设计·erp·definition-driven
BruceNeter1 天前
C# winform卡死问题分析1——线程池子线程创建句柄
c#·.net
Jeff-Tsai2 天前
Day 23:API Payload 安全管道:顺序、保护等级与密钥
.net·架构设计·erp·definition-driven
IT规划师2 天前
Redis 核心机制 | 内存淘汰策略全解:8种策略、近似LRU采样、LFU计数器
redis·.net
何以解忧唯有撸码3 天前
开源】当桌面图标开始打台球:我用 WinForms 做了一桌“真的”台球
c#·winform·自定义控件·gdi
国家一级摸鱼选手3 天前
[Unity]几何碰撞检测:SAT 分离轴定理详解(从数学原理到 C# 实现)
unity·c#·游戏引擎·分离轴定理(sat)·多边形相交
Jeff-Tsai3 天前
Day 22:XML、JSON 与 MessagePack 的分工
.net·架构设计·erp·definition-driven