无法将MyFilter转换为IFilterMetadata，响应修改实现遇阻

需求是在控制器返回响应给客户端前修改响应内容，尝试通过实现IActionResult接口来实现，但调用接口时抛出异常：

Unable to cast object of type 'MyAPI.Api.Middleware.MyFilter' to type 'Microsoft.AspNetCore.Mvc.Filters.IFilterMetadata'

现有代码 #

自定义类MyFilter #

public class MyFilter: IActionResult
{
    ApiResponse _response = new ApiResponse();
    public async Task ExecuteResultAsync(ActionContext context)
    {
        
        var httpResponse = context.HttpContext.Response;
        if (httpResponse != null)
        {
            if (httpResponse.StatusCode == 200)
            {
               
                if (context.Result.GetType().Equals(typeof(Microsoft.AspNetCore.Mvc.ObjectResult)))
                {
                    _response.Response = ((Microsoft.AspNetCore.Mvc.ObjectResult)context.Result).Value;
                    _response.Errors = null;
                    _response.IsSuccess = true;
                }

            }
        }

        return ;
    }
}

Program.cs配置 #

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

builder.Services.AddSingleton<MyFilter>();
builder.Services.AddAppServices();
builder.Services.AddControllers();
builder.Services.AddDataContext(builder.Configuration);
builder.Services.AddRepositories();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

var app = builder.Build();

app.UseSwagger();
app.UseSwaggerUI();
app.UseRouting();
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

控制器配置 #

[Route("api/[controller]")]
[ApiController]
[ServiceFilter(typeof(MyFilter))]
public class MyController : ControllerBase
{
}

错误根源 #

你混淆了IActionResult与过滤器的职责：

• IActionResult是响应结果的实现接口，用于生成最终的HTTP响应内容，并非用于拦截或修改已有的响应流程。
• [ServiceFilter]特性要求目标类必须实现IFilterMetadata接口（如IAsyncActionFilter、IAsyncResultFilter等过滤器接口），而你的MyFilter仅实现了IActionResult，因此触发类型转换异常。

正确实现 #

要在响应发送前修改内容，需实现结果过滤器，推荐使用IAsyncResultFilter（异步版本更符合ASP.NET Core的设计）：

修改后的MyFilter代码 #

public class MyFilter : IAsyncResultFilter
{
    public async Task OnResultExecutionAsync(ResultExecutingContext context, ResultExecutionDelegate next)
    {
        // 仅处理成功状态码的ObjectResult类型响应
        if (context.HttpContext.Response.StatusCode == StatusCodes.Status200OK && 
            context.Result is ObjectResult objectResult)
        {
            // 用自定义ApiResponse包装原响应数据
            var apiResponse = new ApiResponse
            {
                Response = objectResult.Value,
                Errors = null,
                IsSuccess = true
            };

            // 替换原响应结果
            context.Result = new ObjectResult(apiResponse)
            {
                StatusCode = objectResult.StatusCode
            };
        }

        // 继续执行后续流程，发送修改后的响应
        await next();
    }
}

配置说明 #

1. 服务注册：Program.cs中builder.Services.AddSingleton<MyFilter>()的配置无需修改。
2. 控制器特性：保留[ServiceFilter(typeof(MyFilter))]即可，因为IAsyncResultFilter继承自IFilterMetadata，符合特性要求。

全局生效可选配置 #

如果需要对所有控制器接口生效，无需逐个添加特性，可在Program.cs中注册全局过滤器：

builder.Services.AddControllers(options =>
{
    options.Filters.Add<MyFilter>();
});

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