ASP.NET Core中如何复用控制器同时支持Web应用与Web API？

针对你想复用同一控制器逻辑，同时返回JSON（API）和视图（Web GUI）的需求，以下是几种高效且避免重复代码的方案：

方案1：自定义Action Result（推荐） #

把判断返回类型的逻辑封装成自定义的IActionResult实现，控制器方法只需返回这个统一结果，不用在每个方法里写重复判断。

实现自定义HybridResult #

public class HybridResult : IActionResult
{
    private readonly object _model;
    private readonly string _viewName;

    public HybridResult(object model, string viewName = null)
    {
        _model = model;
        _viewName = viewName;
    }

    public async Task ExecuteResultAsync(ActionContext context)
    {
        var request = context.HttpContext.Request;
        // 通过路由前缀判断是否为API请求（也可改用Accept请求头）
        bool isApiRequest = request.Path.StartsWithSegments("/api");

        IActionResult targetResult = isApiRequest 
            ? new JsonResult(_model) 
            : new ViewResult { ViewName = _viewName, Model = _model };

        await targetResult.ExecuteResultAsync(context);
    }
}

控制器中使用 #

public class ProductController : Controller
{
    private readonly IProductService _productService;

    public ProductController(IProductService productService)
    {
        _productService = productService;
    }

    public IActionResult Details(int id)
    {
        var product = _productService.GetById(id);
        // 统一返回HybridResult，无需手动判断
        return new HybridResult(product, "Details");
    }
}

方案2：Action Filter自动转换结果 #

如果不想修改控制器的返回类型，可以用Action Filter在请求执行完成后，根据路由或请求头自动转换返回结果。

实现HybridResponseFilter #

public class HybridResponseFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context) { }

    public void OnActionExecuted(ActionExecutedContext context)
    {
        // 仅处理ViewResult，自动转换为JsonResult（当是API请求时）
        if (context.Result is ViewResult viewResult)
        {
            var isApiRequest = context.HttpContext.Request.Path.StartsWithSegments("/api");
            if (isApiRequest)
            {
                context.Result = new JsonResult(viewResult.Model);
            }
        }
    }
}

注册过滤器 #

可以给单个控制器添加过滤器：

[TypeFilter(typeof(HybridResponseFilter))]
public class ProductController : Controller
{
    // 控制器方法正常返回ViewResult即可
    public IActionResult Details(int id)
    {
        var product = _productService.GetById(id);
        return View("Details", product);
    }
}

也可以全局注册过滤器，让所有控制器生效。

关于你之前的方案：多路由+URL判断 #

这个方案本身是合理的，但手动在每个方法里加判断会导致代码冗余。上面的两种方案本质是把判断逻辑抽离出来，既保留了路由区分的思路，又避免了重复代码，是更优的实现方式。

额外建议 #

• 路由区分时，建议给API设置统一前缀（如/api），便于快速识别请求类型。
• 也可以改用Accept请求头判断（比如API请求携带Accept: application/json），这种方式更符合REST规范，但需要客户端配合设置请求头。

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