Azure App Service失败请求日志异常，如何排查该问题？

1. 补全日志采集配置 #

生产环境日志缺失是排查的核心障碍，先从日志配置入手：

• 检查appsettings.json或环境变量的日志级别，确保Error、Warning及业务关键日志未被过滤，示例配置：

  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning",
      "YourApiNamespace": "Debug"
    }
  }
  

• 调整Application Insights采样率，生产环境默认采样率可能过滤了大部分日志，在Program.cs中修改：

  builder.Services.AddApplicationInsightsTelemetry(options =>
  {
      options.SamplingSettings = new SamplingSettings
      {
          IsEnabled = true,
          MaxTelemetryItemsPerSecond = 100 // 根据业务量调整，避免关键日志被采样过滤
      };
  });
  

• 开启App Service的日志流和详细错误日志：在Azure门户进入对应App Service的「监测」->「日志流」，实时查看应用运行时的控制台输出、未被AI捕获的异常信息。

2. 对比生产与个人环境的配置差异 #

个人账号部署的API正常，说明代码本身无问题，重点排查生产环境的配置差异：

• 核对应用设置：对比生产与个人环境的连接字符串、第三方服务密钥、环境变量等，确认生产环境配置值无遗漏、格式错误；
• 验证网络与权限：检查生产环境Web API是否能访问依赖资源（数据库、Redis、第三方API）：
  • 确认App Service出站网络规则允许访问目标IP/端口；
  • 若使用VNet集成，检查子网权限配置；
  • 验证数据库防火墙规则是否允许App Service的IP或服务标签访问；
• 确认运行时版本：生产App Service的.NET/运行时版本需与本地、个人环境一致，避免兼容性问题。

3. 排查请求路由与身份验证问题 #

部分功能失效常与路由或认证相关：

• 检查路由配置：确认Web API路由模板是否适配生产环境的URL前缀（如自定义域名、App Service默认域名），避免路由匹配失败；
• 验证身份验证/授权：若涉及认证，检查生产环境的Azure AD/JWT配置是否正确，令牌有效性、权限范围是否匹配；可在日志中添加令牌解析的非敏感关键信息辅助排查。

4. 利用Azure内置诊断工具 #

• 使用App Service的诊断和解决问题功能：在Azure门户进入该页面，选择「可用性和性能」「应用程序错误」类诊断工具（如Web App Down Detector），自动排查常见问题；
• 开启失败请求跟踪：捕获具体失效请求的详细错误信息，包括状态码、异常堆栈、模块处理流程，定位故障节点。

5. 本地模拟生产环境调试 #

若无法直接调试生产环境，可在本地复刻生产条件：

• 将生产环境的应用设置复制到本地appsettings.Production.json，以生产环境模式运行（dotnet run --environment Production），尝试复现问题；
• 使用本地模拟器（如Azure Storage Emulator）模拟生产依赖资源，排查配置或资源访问类问题。

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