.NET 5 Web API Serilog对接Elasticsearch本地正常IIS部署后无日志如何解决

排查与解决步骤 #

• 修复配置读取路径问题
  你的ConfigureLogging方法中初始化ConfigurationBuilder时未指定配置文件的根路径，IIS运行时默认工作目录不是应用部署目录，会导致读不到appsettings.json，直接造成Serilog初始化失败。修改代码如下：

var configuration = new ConfigurationBuilder()
    // 新增这行，指定配置文件根目录为应用部署目录
    .SetBasePath(AppContext.BaseDirectory)
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT")}.json", optional: true)
    .Build();

同时建议同步给CreateHostBuilder里的ConfigureAppConfiguration也加上SetBasePath(AppContext.BaseDirectory)配置，避免两边路径不一致。

• 开启Serilog自诊断定位具体错误
  Serilog默认会吞掉初始化、写入日志的报错，添加自诊断逻辑可以直接定位问题：在ConfigureLogging方法最开头添加如下代码，将Serilog内部错误输出到有权限的目录：

// 提前创建C:\Temp目录，并给IIS应用池身份赋予该目录的读写权限
Serilog.Debugging.SelfLog.Enable(msg => File.WriteAllText(@"C:\Temp\serilog_errors.txt", msg + Environment.NewLine));

访问接口后查看该文件的报错信息，可直接定位是配置读取失败、ES连接失败还是权限问题。

• 检查IIS站点环境变量配置
  进入IIS管理器，找到对应站点的「配置编辑器」，选择system.webServer/aspNetCore节，查看environmentVariables配置中是否添加了ASPNETCORE_ENVIRONMENT变量，值是否和你本地的环境一致。如果没有配置，默认会读取appsettings.Production.json，若该文件不存在或ES地址配置错误，也会导致日志写入失败。

• 检查ES连接和权限
  确认IIS服务器可以正常访问配置的ES地址，可在IIS服务器上用浏览器或curl工具访问http://你的ES地址:端口验证连通性。如果ES配置了身份验证，需要在ElasticsearchSinkOptions中补充ModifyConnectionSettings配置，指定用户名密码。

• 检查IIS应用池权限
  确保应用池运行身份（默认是IIS AppPool\你的应用池名称）对应用部署目录有读取和执行权限，对需要写入本地文件的目录有写入权限。

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