This is 迷恋自留地.|

今晚打老虎!

园龄:5年1个月粉丝:39关注:9

ASP.NET Core 中的超时中间件

ASP.NET Core 中的超时中间件

在ASP.NET Core中,超时中间件允许为HTTP请求设置超时限制,以提高应用程序的健壮性和响应能力。

1. 添加超时中间件到应用

需要在的服务集合中添加请求超时中间件,再将其添加到请求处理管道中。

using Microsoft.AspNetCore.Http.Timeouts;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddRequestTimeouts(); // 添加到服务集合
var app = builder.Build();
app.UseRequestTimeouts(); // 添加到请求处理管道

2. 配置单个终结点或页面

对于最小API应用,可以通过调用WithRequestTimeout或者用[RequestTimeout]属性来配置终结点超时。

app.MapGet("/", async (HttpContext context) => {
    try
    {
        await Task.Delay(TimeSpan.FromSeconds(10), context.RequestAborted);
    }
    catch (TaskCanceledException)
    {
        return Results.Content("Timeout!", "text/plain");
    }
    return Results.Content("No timeout!", "text/plain");
}).WithRequestTimeout(TimeSpan.FromSeconds(2)); // 设置超时时间为2秒

也可以使用属性的方式:

app.MapGet("/attribute", 
    [RequestTimeout(milliseconds: 2000)] async (HttpContext context) => {
        try
        {
            await Task.Delay(TimeSpan.FromSeconds(10), context.RequestAborted);
        }
        catch (TaskCanceledException)
        {
            return Results.Content("Timeout!", "text/plain");
        }
        return Results.Content("No timeout!", "text/plain");
    });

3. 配置多个终结点或页面

也可以创建命名策略来指定超时配置,这些配置可以应用于多个终结点。通过调用AddPolicy添加策略:

builder.Services.AddRequestTimeouts(options => {
    options.DefaultPolicy = 
        new RequestTimeoutPolicy { Timeout = TimeSpan.FromMilliseconds(1500) };
    options.AddPolicy("MyPolicy", TimeSpan.FromSeconds(2));
});

可以通过策略名称为终结点指定超时:

app.MapGet("/namedpolicy", async (HttpContext context) => {
     //设置10s任务
    return Results.Content("No timeout!", "text/plain");
}).WithRequestTimeout("MyPolicy"); // 使用命名策略

4. 设置全局默认超时策略

也可以为全局默认超时配置指定一个策略:

builder.Services.AddRequestTimeouts(options => {
    options.DefaultPolicy = 
        new RequestTimeoutPolicy { Timeout = TimeSpan.FromMilliseconds(1500) };
});

默认超时将适用于没有指定超时的终结点。

5. 在策略中指定状态码

RequestTimeoutPolicy类有一个属性,可以在超时触发时自动设置状态码:

builder.Services.AddRequestTimeouts(options => {
    options.DefaultPolicy = new RequestTimeoutPolicy
    {
        Timeout = TimeSpan.FromMilliseconds(1500),
        TimeoutStatusCode = (int)HttpStatusCode.InternalServerError
    };
});

每个超时的请求都将具有状态码500(内部服务器错误)。

6. 禁用特定终结点的请求超时

有时可能想要禁用特定终结点的默认超时策略。对于最小API,可以使用[DisableRequestTimeout]属性

app.MapGet("/GetCharacter",
    [DisableRequestTimeout] async (HttpContext context, ICharacterService characterService) => {
        return await characterService.GetCharacterAsync(context.RequestAborted);
    });

对于控制器,可以使用[DisableRequestTimeout]属性来覆盖默认的超时策略:

[HttpGet("GetCharacter")]
[DisableRequestTimeout]
public async Task<Character> GetCharacterAsync()
    => await _characterService.GetCharacterAsync(HttpContext.RequestAborted);

通过合理配置超时策略,可以确保应用程序在处理时间上保持健壮和响应性。

本文作者:今晚打老虎!

本文链接:https://www.cnblogs.com/netcore5/p/18687368

版权声明:本作品采用知识共享署名-非商业性使用-禁止演绎 2.5 中国大陆许可协议进行许可。

posted @   今晚打老虎!  阅读(11)  评论(0编辑  收藏  举报
相关博文:
阅读排行:
· DeepSeek “源神”启动!「GitHub 热点速览」
· 我与微信审核的“相爱相杀”看个人小程序副业
· 上周热点回顾(2.17-2.23)
· 如何使用 Uni-app 实现视频聊天(源码,支持安卓、iOS)
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
点击右上角即可分享
微信分享提示
评论
收藏
关注
推荐
深色
回顶
收起