.NET 6独立部署Web应用程序集裁剪禁用及加载问题咨询

一、裁剪相关问题解答 #

1. 裁剪默认开启吗？ #

.NET 6自包含发布默认不开启裁剪，只有当你在项目文件里显式设置<PublishTrimmed>true</PublishTrimmed>时才会启用。你已经手动开启了裁剪，这几乎肯定是反射失效的根源。

2. 能不能关闭裁剪？ #

当然可以。直接删掉MyWebApp.csproj里的<PublishTrimmed>true</PublishTrimmed>配置就行。关闭后，自包含发布会保留所有依赖程序集，反射加载类的逻辑就能正常跑起来。

3. 必须保留裁剪的话，怎么正确配置？ #

如果非要用裁剪来缩小包体积，只加<IsTrimmable>false</IsTrimmable>不够——裁剪器只会识别静态代码引用，反射调用的代码会被判定为“未使用”而被剪掉。得做以下配置：

• 全程序集豁免：在MyWebApp.Data、MyWebApp.Connectors等依赖项目的csproj里，除了<IsTrimmable>false</IsTrimmable>，再加<TrimMode>partial</TrimMode>，确保裁剪器不会动这些程序集里的任何类型。
• 标记反射目标：用[DynamicDependency]特性把反射用到的类型标出来。比如你要反射加载MyWebApp.Data.Services.UserService的注册方法，就在启动类里加：

  [DynamicDependency(DynamicallyAccessedMemberTypes.All, typeof(MyWebApp.Data.Services.UserService))]
  public class Program
  {
      // 启动逻辑
  }
  

• 用link.xml配置文件：创建link.xml（设置为“始终复制到输出目录”），明确指定要保留的程序集和类型：

  <linker>
    <assembly fullname="MyWebApp.Data">
      <type fullname="*" preserve="all"/>
    </assembly>
    <assembly fullname="MyWebApp.Connectors">
      <type fullname="*" preserve="all"/>
    </assembly>
  </linker>
  

• 预览裁剪效果：用dotnet trim --dry-run命令预览裁剪行为，确认不会删掉反射依赖的类型，避免发布后踩坑。

二、非裁剪场景的排查方向 #

如果确认裁剪已经关闭，但问题还在，从这些地方查：

• 检查发布包完整性：对比本地Release发布和Azure DevOps Pipeline输出的文件夹，看看MyWebApp.Data、MyWebApp.Connectors这些依赖程序集有没有丢，版本对不对。Pipeline可能存在打包遗漏，比如没把依赖项目的输出包含进去。
• 确认程序集加载路径：自包含应用的加载路径和本地可能不一样，用AppDomain.CurrentDomain.BaseDirectory或者Assembly.GetExecutingAssembly().Location输出当前加载路径，检查依赖程序集是不是在这个目录下。
• 检查反射逻辑：看看反射代码有没有写错程序集名称、类型名称的大小写，是不是误过滤了依赖项目的程序集。可以加日志输出所有加载的程序集全名，确认目标程序集有没有被加载。
• 排查Pipeline配置：检查Azure DevOps的发布任务用的命令对不对，比如是不是dotnet publish -c Release -r <runtime> --self-contained true，有没有加--no-dependencies这种会漏掉依赖的参数。
• 捕获加载异常：在反射加载的代码里加try-catch，抓FileNotFoundException、FileLoadException这些异常，输出详细错误信息（比如缺哪个程序集、版本多少），精准定位问题。

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