ASP.NET Core 6 Web API：基于请求头设置DI注入的基类控制器变量

1. 是否可在ApiBaseController内直接获取请求头并调用SetTenant？ #

可以直接在ApiBaseController中获取请求头。Web API控制器继承的ControllerBase基类支持重写OnActionExecutionAsync方法（MVC和Web API共享该基类），完全可以通过HttpContext.Request.Headers访问请求头并设置租户标识。示例代码：

public class ApiBaseController : ControllerBase
{
    private readonly ITenantService _tenantService;

    public ApiBaseController(ITenantService tenantService)
    {
        _tenantService = tenantService;
    }

    public override async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
    {
        if (HttpContext.Request.Headers.TryGetValue("X-Tenant-Id", out var tenantId))
        {
            _tenantService.SetTenant(tenantId.ToString());
        }

        await base.OnActionExecutionAsync(context, next);
    }
}

2. 控制器生命周期及状态共享要求 #

• 控制器默认生命周期为Transient，每个请求会生成新实例，但这不会影响状态共享。
• 核心要求是ITenantService必须注册为Scoped生命周期：每个请求对应一个ITenantService实例，确保中间件/过滤器和控制器使用的是同一个实例，状态能在请求内正常传递。
• 无需修改控制器的默认生命周期，重点保证ITenantService的Scoped注册即可。

3. 自定义中间件中共享ITenantService状态到控制器 #

中间件本身是Singleton生命周期，不能在构造函数中直接注入Scoped的ITenantService（会导致生命周期不匹配，引发跨请求状态混乱）。正确做法是在InvokeAsync方法中通过当前请求的服务容器获取Scoped实例：

正确的中间件实现 #

public class TenantMiddleware
{
    private readonly RequestDelegate _next;

    public TenantMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    // 直接注入ITenantService，ASP.NET Core会自动从当前请求容器中获取Scoped实例
    public async Task InvokeAsync(HttpContext context, ITenantService tenantService)
    {
        if (context.Request.Headers.TryGetValue("X-Tenant-Id", out var tenantId))
        {
            tenantService.SetTenant(tenantId.ToString());
        }

        await _next(context);
    }
}

// 扩展方法用于注册中间件
public static class TenantMiddlewareExtensions
{
    public static IApplicationBuilder UseTenantMiddleware(this IApplicationBuilder app)
    {
        return app.UseMiddleware<TenantMiddleware>();
    }
}

注册中间件（Program.cs） #

var builder = WebApplication.CreateBuilder(args);

// 注册Scoped的ITenantService
builder.Services.AddScoped<ITenantService, TenantService>();

var app = builder.Build();

// 在路由中间件前注册租户中间件
app.UseTenantMiddleware();

app.MapControllers();

app.Run();

4. 自定义过滤器的生命周期及接口要求 #

• 若过滤器继承ActionFilterAttribute，默认是Singleton生命周期。如果需要依赖Scoped的ITenantService，必须将过滤器注册为Scoped，否则会引发生命周期冲突。
• 建议实现IAsyncActionFilter（或同步的IActionFilter）接口，通过ServiceFilterAttribute或TypeFilterAttribute使用，或直接注册为Scoped服务。

正确的过滤器实现 #

public class TenantActionFilter : IAsyncActionFilter
{
    private readonly ITenantService _tenantService;

    public TenantActionFilter(ITenantService tenantService)
    {
        _tenantService = tenantService;
    }

    public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
    {
        if (context.HttpContext.Request.Headers.TryGetValue("X-Tenant-Id", out var tenantId))
        {
            _tenantService.SetTenant(tenantId.ToString());
        }

        await next();
    }
}

注册过滤器（Program.cs） #

// 注册为Scoped服务
builder.Services.AddScoped<TenantActionFilter>();

// 全局注册过滤器（可选）
builder.Services.AddControllers(options =>
{
    options.Filters.Add<ServiceFilterAttribute>(typeof(TenantActionFilter));
});

// 或在控制器/方法上局部使用
[ServiceFilter(typeof(TenantActionFilter))]
public class TestController : ApiBaseController
{
    // ...
}

状态不持久问题排查 #

之前遇到的状态无法传递，通常是以下原因：

1. ITenantService被注册为Singleton：多个请求共享同一实例，状态被覆盖或混乱。
2. 中间件构造函数注入Scoped服务：导致拿到的是Singleton实例，无法实现请求内状态隔离。
3. 过滤器为Singleton且直接注入Scoped服务：引发生命周期冲突，拿到的服务实例不属于当前请求。

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