ASP.NET Core 6 MVC使用OnException、HandleError遇报错，求助解决

1. OnException 重写报错 "No suitable method found to override" #

ASP.NET Core MVC 已移除旧版 ASP.NET MVC 中 Controller 基类的 OnException 虚拟方法，直接重写会触发该错误。可通过以下两种方案解决：

方案一：自定义异常过滤器 #

创建继承自 ExceptionFilterAttribute 的过滤器，重写其 OnException 方法实现异常处理：

public class CustomExceptionFilter : ExceptionFilterAttribute
{
    public override void OnException(ExceptionContext context)
    {
        if (!context.ExceptionHandled)
        {
            // 异常日志记录逻辑（可注入ILogger实现）
            // _logger.LogError(context.Exception, "未处理异常");
            
            // 返回错误视图
            context.Result = new ViewResult
            {
                ViewName = "Error",
                ViewData = new ViewDataDictionary(new EmptyModelMetadataProvider(), context.ModelState)
                {
                    {"ErrorMessage", context.Exception.Message}
                }
            };
            context.ExceptionHandled = true;
        }
    }
}

注册过滤器：

• 全局注册：在 Program.cs 中配置

  builder.Services.AddControllersWithViews(options =>
  {
      options.Filters.Add<CustomExceptionFilter>();
  });
  

• 控制器/方法级注册：在目标控制器或 Action 上添加特性 [CustomExceptionFilter]

方案二：全局异常处理中间件 #

在 Program.cs 中配置全局异常处理中间件：

app.UseExceptionHandler("/Home/Error");

然后在 HomeController 中添加错误处理 Action：

public IActionResult Error()
{
    var exceptionFeature = HttpContext.Features.Get<IExceptionHandlerPathFeature>();
    var errorMsg = exceptionFeature?.Error.Message ?? "发生未知错误";
    return View(new ErrorViewModel { ErrorMessage = errorMsg });
}

2. [HandleError] 特性报错 #

旧版 ASP.NET MVC 的 [HandleError] 特性已在 ASP.NET Core 中移除，直接使用会提示找不到该特性。可采用上述自定义异常过滤器或全局异常处理中间件替代其功能。

3. @helper 标签无法使用 #

ASP.NET Core Razor 已移除 @helper 语法，可通过以下三种方案替代：

方案一：使用局部视图 #

创建局部视图（如 _CustomHelper.cshtml）封装原 @helper 逻辑：

@model string
<div class="helper-container">
    <span>@Model</span>
</div>

在主视图中调用：

<partial name="_CustomHelper" model="局部视图示例内容" />

方案二：创建静态 HTML 辅助扩展方法 #

创建静态类实现自定义 HTML 辅助方法：

public static class HtmlHelperExtensions
{
    public static IHtmlContent CustomHelper(this IHtmlHelper html, string content)
    {
        var tag = new TagBuilder("div");
        tag.AddCssClass("helper-container");
        tag.InnerHtml.AppendHtml($"<span>{content}</span>");
        return tag;
    }
}

在视图中引用命名空间后调用：

@using YourProjectNamespace.Helpers
@Html.CustomHelper("HTML辅助方法示例内容")

方案三：使用自定义 Tag Helper #

创建 Tag Helper 类：

[HtmlTargetElement("custom-helper")]
public class CustomHelperTagHelper : TagHelper
{
    [HtmlAttributeName("content")]
    public string Content { get; set; }

    public override void Process(TagHelperContext context, TagHelperOutput output)
    {
        output.TagName = "div";
        output.Attributes.Add("class", "helper-container");
        output.Content.AppendHtml($"<span>{Content}</span>");
    }
}

在 _ViewImports.cshtml 中注册 Tag Helper：

@addTagHelper *, YourProjectNamespace

在视图中使用：

<custom-helper content="Tag Helper示例内容"></custom-helper>

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