私有NuGet包引用导致.NET Core 2 Web应用运行时故障求助

排查步骤与解决方案 #

优先级最高的排查点（匹配90%以上该场景的问题） #

你提到清空B的代码和引用后通过NuGet引用仍有故障，直接引用本地dll正常，首先检查B的NuGet包元数据：

• 把B的nupkg文件改后缀为.zip解压，打开*.nuspec元数据文件，查看<dependencies>节点下是否仍残留Microsoft.Extensions.Logging.Abstractions 5.0.0、Newtonsoft.Json 13.0.1的依赖声明
• 该场景的核心诱因大概率是：你清空B项目的引用仅删除了本地项目的PackageReference，但打包时未同步清理nuspec依赖，NuGet安装B包时会自动将你的.NET Core 2.2项目里自带的2.2版本Microsoft.Extensions.*组件强制升级到5.0版本，而5.0版本的扩展包不兼容.NET Core 2.2，运行时ASP.NET Core内置中间件加载ILogger相关接口时签名不匹配，静默失败导致请求无法进入端点，且不会抛出可捕获的异常
• 解决方法：修改B项目的打包配置，确保清空无用依赖后再打包，或者在B项目的PackageReference中对外部引用加上PrivateAssets="all"标记，避免依赖传递到引用B的项目中

次优先级排查路径 #

如果确认nuspec依赖无问题，按以下顺序排查：

1. 对比两种引用模式的发布输出
   • 分别生成「本地直接引用B.dll」和「NuGet引用B包」两个版本的发布包，用文件对比工具逐文件比对：
     • 检查web.config的绑定重定向规则是否有差异，错误的绑定重定向会导致.NET Core 2.2运行时程序集加载失败
     • 检查输出目录下的Microsoft.Extensions.*、Newtonsoft.Jsondll的版本是否一致
2. 捕获被吞的异常日志
   • 在项目Program.cs的Main方法最外层加全局异常捕获，将异常信息写入本地文本文件，避免异常被IIS/ASP.NET Core宿主静默吞掉：

public static void Main(string[] args)
{
    try
    {
        CreateWebHostBuilder(args).Build().Run();
    }
    catch (Exception ex)
    {
        File.WriteAllText(@"C:\temp\startup_error.log", ex.ToString());
        throw;
    }
}

• 将appsettings.json中的日志级别调整为Trace，输出所有运行时日志，重点查看程序集加载相关的报错：

{
  "Logging": {
    "LogLevel": {
      "Default": "Trace",
      "Microsoft": "Trace",
      "System": "Trace"
    }
  }
}

3. 检查NuGet包的额外注入逻辑
   • 解压后的B包中是否存在build、buildTransitive文件夹，里面的.props/.targets文件会在项目编译/发布时自动注入额外逻辑，本地直接引用dll不会触发该逻辑，这类注入的逻辑可能会修改ASP.NET Core的启动配置
4. 验证部署模式影响
   • 发布时加上--self-contained true参数打独立部署包，排除服务器全局NuGet缓存中存在损坏的依赖包的问题

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