为何手动触发的Azure WebJob运行失败不显示正确错误日志？

常见故障原因及修复方式 #

• 依赖文件缺失
  仅上传bin>Release路径下的单个exe文件无法正常运行：Visual Studio 2017的WebJob发布流程会自动打包所有关联项目的程序集、第三方依赖DLL、配置文件、资源文件，单独上传exe会导致程序启动时找不到依赖项直接闪退，此时Application Insights尚未完成初始化，自然无法采集到任何日志。
  不要手动上传单个exe文件，直接使用VS自带的Publish Azure Webjob功能完成全量发布，发布完成后可通过Kudu进入站点的wwwroot/App_Data/jobs/triggered/[你的WebJob名称]目录，确认所有关联项目生成的DLL、和exe同名的.config配置文件（由App.config发布转换生成）都已存在于部署目录中。
• 配置文件部署异常
  检查发布后的.config文件是否完整带上了Azure文件共享、SQL Server的所有连接字符串配置，避免发布配置转换过程中意外删除配置节点；如果连接字符串包含&等XML特殊字符，必须做对应转义（比如&转义为&），否则配置文件加载失败会直接导致程序启动崩溃。
• 运行时版本不匹配
  确认项目编译时的目标框架版本，和Azure App Service应用程序池配置的.NET版本完全对齐：比如项目基于.NET Framework 4.8编译，但App Service配置的.NET版本为4.7.2，就会出现启动即失败、无有效日志的问题。版本配置可在Azure门户App Service的「配置-常规设置」页调整。
• 启动阶段无异常兜底日志
  由于Application Insights初始化完成前抛出的异常无法被采集，建议在程序Main方法最外层增加全局异常捕获逻辑，将启动阶段的错误直接写入WebJob有写入权限的D:\home\LogFiles目录下，快速定位具体报错：

  static void Main(string[] args)
  {
      try
      {
          // 原有程序初始化、业务执行逻辑
      }
      catch (Exception ex)
      {
          System.IO.File.AppendAllText(@"D:\home\LogFiles\WebJobStartupError.log", 
              $"{DateTime.Now:yyyy-MM-dd HH:mm:ss} 启动异常：{ex}\r\n");
          throw;
      }
  }
  

• 连接权限验证失败
  逐一核对Azure文件共享的存储账号密钥、SQL Server连接串的账号密码是否正确，确认SQL Server防火墙已放通App Service的出站IP，避免初始化阶段连接资源失败导致程序直接退出。

快速排查流程 #

1. 使用VS的WebJob发布功能完成全量重新部署，不要手动上传单个exe文件
2. 通过Kudu确认部署目录下依赖文件、配置文件完整无缺失
3. 本地切换到Release配置运行编译生成的exe，确认本地启动无依赖缺失类报错
4. 添加上述全局启动异常捕获逻辑后重新发布触发，通过LogFiles目录下的错误日志定位具体根因

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