WebJobs中使用log4net写日志异常：仅部署时生效，调度时失效

我之前帮不少开发者解决过类似的Azure WebJob日志问题，咱们一步步拆解可能的原因和解决办法：

1. 先排查文件路径与运行上下文的差异 #

WebJob首次部署运行时，是在Azure部署引擎的上下文环境中，而后续触发调度时，是在App Service运行时用户（比如IIS APPPOOL\你的应用池名称）的上下文里，两者的工作目录可能不一样。如果你的log4net配置用的是相对路径（比如MyLogs.txt），首次运行可能写入WebJob根目录，但后续调度可能写到了App Service的site\wwwroot或者其他路径，导致你以为没生成日志。

解决办法： #

• 在代码里添加调试输出，确认log4net实际的日志路径：

  var fileAppender = LogManager.GetRepository()
                               .GetAppenders()
                               .OfType<log4net.Appender.FileAppender>()
                               .FirstOrDefault();
  if (fileAppender != null)
  {
      // 这个输出会出现在Azure门户的WebJob日志里
      Console.WriteLine($"当前日志文件路径：{fileAppender.File}");
  }
  

  部署后触发一次调度，去WebJob的日志里查看路径，确认是不是和你预期的一致。
• 配置log4net时使用绝对路径，比如指向App Service的持久存储目录：

  <appender name="FileAppender" type="log4net.Appender.RollingFileAppender">
    <file value="D:\home\site\wwwroot\App_Data\Jobs\triggered\你的WebJob名称\MyLogs.txt" />
    <!-- 其他配置 -->
  </appender>
  

2. 检查log4net配置文件的加载问题 #

你代码里调用XmlConfigurator.Configure()时没有指定配置文件路径，默认会加载程序目录下的YourWebJob.exe.config。如果这个配置文件没有被正确部署，或者调度运行时找不到，log4net会使用默认配置（可能不输出到文件）。

解决办法： #

• 在Visual Studio中，右键你的App.Config文件，设置复制到输出目录为「始终复制」，确保编译后的配置文件会被打包到WebJob部署包中。
• 显式指定配置文件路径，避免上下文差异导致加载失败：

  var configPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "YourWebJobName.exe.config");
  log4net.Config.XmlConfigurator.Configure(new FileInfo(configPath));
  

3. 日志文件锁定问题 #

如果首次运行时log4net锁定了日志文件，后续调度的进程就无法写入。默认的FileAppender会保持文件锁定状态，直到进程退出，但触发式WebJob每次调度都是新进程，不过如果是连续运行的WebJob，进程一直存活的话就会出现这个问题。

解决办法： #

在log4net的Appender配置中添加MinimalLock，让log4net只在写入日志时短暂锁定文件：

<appender name="FileAppender" type="log4net.Appender.RollingFileAppender">
  <file value="MyLogs.txt" />
  <!-- 添加这行配置 -->
  <lockingModel type="log4net.Appender.FileAppender+MinimalLock" />
  <appendToFile value="true" />
  <rollingStyle value="Size" />
  <maxSizeRollBackups value="5" />
  <maximumFileSize value="10MB" />
  <layout type="log4net.Layout.PatternLayout">
    <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
  </layout>
</appender>

4. 运行时权限检查 #

App Service的运行时用户可能没有日志目录的写入权限。首次部署时用的是部署用户权限，权限较高，但后续调度用的是应用池用户，权限有限。

解决办法： #

• 登录Azure门户的Kudu控制台（https://你的应用名.scm.azurewebsites.net/），用命令检查目录权限：

  icacls D:\home\site\wwwroot\App_Data\Jobs\triggered\你的WebJob名称
  

• 如果权限不足，赋予应用池用户写入权限：

  icacls D:\home\site\wwwroot\App_Data\Jobs\triggered\你的WebJob名称 /grant "IIS APPPOOL\你的应用池名称":(W)
  

5. 检查WebJob调度日志 #

即使log4net无法写入日志，WebJob自身的控制台日志会记录进程启动时的异常（比如文件权限不足、配置文件找不到等）。你可以在Azure门户的WebJob页面→「日志」里查看每次调度的运行日志，里面会有详细的错误信息。

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