.NET无法找到嵌入在可执行文件中的程序集——原因何在？

针对你遇到的极少数用户出现securifybv.ShellLink程序集找不到的问题，结合.NET 6单文件发布的机制，以下是几个关键排查方向和解决办法：

1. 临时目录提取失败或被拦截 #

.NET 6单文件发布的应用在运行时会将嵌入的程序集提取到系统临时目录（默认是%TEMP%\.net\<应用名>），如果用户的临时目录存在权限不足、磁盘空间不足，或者被杀毒软件/安全工具拦截了该程序集的写入/读取操作，就会触发找不到文件的异常。

• 解决办法：
  • 在应用启动时添加日志，记录临时目录路径和写入权限检查结果；
  • 引导用户排查安全软件是否拦截了应用的文件操作；
  • 通过配置指定自定义提取目录，在csproj中添加：

    <PropertyGroup>
      <SelfExtractDir>C:\CustomPath\YourApp</SelfExtractDir>
    </PropertyGroup>
    

    注意该目录需要用户具备读写权限。

2. 程序集未被正确嵌入 #

检查发布配置是否确保securifybv.ShellLink被嵌入到单文件中：

• 确认csproj中没有针对该程序集的排除规则，比如是否存在<Private>false</Private>属性，这会导致程序集不被复制/嵌入；
• 确保发布时启用了IncludeAllContentForSelfExtract，在csproj中添加：

  <PropertyGroup>
    <IncludeAllContentForSelfExtract>true</IncludeAllContentForSelfExtract>
  </PropertyGroup>
  

  这个属性会确保所有依赖内容都被嵌入到单文件中。

3. 反射加载导致程序集未被包含 #

如果应用是通过反射（比如Assembly.Load、Activator.CreateInstance）加载securifybv.ShellLink，.NET的静态分析可能无法检测到这个引用，导致发布时未将其嵌入。

• 解决办法：
  • 在代码中添加对该程序集的显式引用（比如声明一个该程序集中的类型变量，即使不用），让编译器能检测到依赖；
  • 在csproj中显式指定要包含的程序集：

    <ItemGroup>
      <EmbeddedResource Include="path\to\securifybv.ShellLink.dll" />
    </ItemGroup>
    

4. 原生依赖未被处理 #

securifybv.ShellLink可能依赖某些原生Win32库（比如与快捷操作相关的系统DLL），.NET 6单文件发布默认不会自动嵌入原生库，若这些原生库在用户系统中缺失或无法被加载，可能间接导致托管程序集加载失败。

• 解决办法：
  • 检查该库的文档或依赖项，确认是否有原生依赖；
  • 将所需的原生库添加到项目中，并设置<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>，同时在发布时通过dotnet publish --include-native-libraries参数确保它们被包含。

5. 运行时程序集缓存冲突 #

极少数情况下，用户系统中可能存在旧版本的securifybv.ShellLink缓存，或者临时目录中的提取文件损坏，导致加载失败。

• 解决办法：
  • 引导用户删除%TEMP%\.net\<你的应用名>目录下的缓存文件，重新启动应用；
  • 在发布时为应用设置唯一的AssemblyVersion，避免缓存冲突。

内容的提问来源于stack exchange，提问作者pizzaboxer