.NET Core 2 Web API添加Microsoft.Extensions.Logging.EventLog包报错问题

这个问题我之前帮同事排查过，其实核心原因是.NET Core 2.x的跨平台特性和Windows Event Log的专属API之间的适配问题，咱们一步步来解决：

为什么会出现这个错误？ #

.NET Core 2.x是跨平台框架，默认的类库不包含System.Diagnostics.EventLog这种Windows专属的API——它只存在于Windows特定的.NET Core运行时包中。你安装Microsoft.Extensions.Logging.EventLog后出现黄色警告，就是因为这个包依赖的Windows API在通用的跨平台.NET Core环境里找不到对应的实现，运行时自然就抛出类型加载失败的错误了。

具体解决方案 #

1. 把项目目标改为Windows专属的.NET Core运行时 #

打开你的项目文件（.csproj），把目标框架节点修改为带-windows后缀的版本，比如：

<PropertyGroup>
  <TargetFramework>netcoreapp2.2-windows</TargetFramework>
</PropertyGroup>

这样项目会自动引用包含Windows专属API的运行时包，从根源上解决类型缺失的问题。

2. 条件化配置EventLog日志提供程序 #

为了避免跨平台部署时出错，建议只在Windows环境下注册EventLog，修改BuildWebHost方法：

using System.Runtime.InteropServices;

public static IWebHost BuildWebHost(string[] args) =>
    WebHost.CreateDefaultBuilder(args)
        .ConfigureLogging(logging =>
        {
            logging.ClearProviders();
            // 仅在Windows系统中添加EventLog提供程序
            if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
            {
                logging.AddEventLog();
            }
            // 保留跨平台的日志提供程序，比如Console
            logging.AddConsole();
        })
        .UseStartup<Startup>()
        .Build();

3. 清理NuGet缓存解决警告 #

如果修改目标框架后仍然有黄色警告，可以尝试清理NuGet缓存后重新还原包：

dotnet nuget locals all --clear
dotnet restore

额外建议 #

如果你的项目没有强版本限制，升级到.NET Core 3.0及以上版本会更省心——从这个版本开始，微软把Windows Event Log的支持做了优化，不需要指定Windows专属的目标框架，相关API会自动根据运行平台加载对应的实现，这类兼容性问题会少很多。

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