Asp.Net Core HealthChecks执行长SQL查询超时，设置TimeSpan无效如何解决？

问题原因 #

你触发的是HttpClient默认100秒超时限制，你在AddCheck中配置的是单个健康检查的执行超时，优先级低于健康检查中间件全局超时和你检查逻辑内部依赖的客户端（HttpClient、数据库客户端）本身的超时配置，所以不生效。

可调整的超时配置项 #

• 调整健康检查中间件全局总超时
  该配置是所有健康检查执行的总超时上限，优先级最高，配置示例：

  app.UseHealthChecks("/health", new HealthCheckOptions
  {
      // 配置全局总超时为5分钟
      Timeout = TimeSpan.FromMinutes(5)
  });
  

• 调整健康检查逻辑内依赖的客户端超时
  你的报错明确指向HttpClient.Timeout，另外长耗时SQL还需要调整数据库命令超时：

  • 如果是检查逻辑内用到自定义HttpClient，注册时调整超时：

    services.AddHttpClient("HealthCheckClient", client =>
    {
        // 调整HttpClient超时为5分钟
        client.Timeout = TimeSpan.FromMinutes(5);
    });
    

  • 如果用到EF Core执行SQL，调整命令超时：

    services.AddDbContext<YourDbContext>(opt =>
        opt.UseSqlServer("连接字符串", sqlOpt => 
            sqlOpt.CommandTimeout(300))); // 300秒=5分钟
    

  • 如果是直接使用SqlCommand执行查询，手动设置CommandTimeout属性为300即可。

• 单个健康检查超时配置
  就是你当前用到的AddCheck传入的Timeout参数，注意该值不能超过上述中间件全局超时的值，否则会被全局配置覆盖。

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