当前位置：移动技术网 > IT编程>开发语言>.net > Asp.NetCore依赖注入和管道方式的异常处理及日志记录

Asp.NetCore依赖注入和管道方式的异常处理及日志记录

2018年11月26日 | 移动技术网IT编程 | 我要评论

都市良人行好看吗,2015yy娱乐年度盛典,异界练级专家

前言

在业务系统，异常处理是所有开发人员必须面对的问题，在一定程度上，异常处理的能力反映出开发者对业务的驾驭水平；本章将着重介绍如何在 webapi 程序中对异常进行捕获，然后利用 nlog 组件进行记录；同时，还将介绍两种不同的
异常捕获方式：管道捕获/服务过滤；通过本练习，将学习到如何捕获异常、处理异常跳转、记录异常信息。

搭建框架

首先，创建一个 webapi 项目，选择 asp.net core web 应用程序；

进一步选择 api 模板，这里使用的 .netcore 版本为 2.1

取消勾选 “启用 docker 支持(e)” 和 “为 https 配置(c)”，点击确定，得到一个完整的 webapi 项目框架，如图

直接按 f5 运行项目，一切正常，程序启动后进入默认路由调用，并输出结果

异常路由

一切看起来都非常正常和美好，但，祸之福所倚；接下来我们在接口 get() 中人为的制造一点麻烦。

        [httpget]
        public actionresult<ienumerable<string>> get()
        {
            throw new exception("出错了.....");

            return new string[] { "value1", "value2" };
        }

这是由于项目配置了运行环境变量 aspnetcore_environment=development 后，startup.cs 中配置了开发环境下，使用系统默认页，所以我们才可以看到上面的异常信息

如果你把环境变量设置为 aspnetcore_environment=production ，你会发现，在异常发生的时候，你得到了一个空白页。

异常处理方式一：服务过滤

在传统的 asp.net mvc 应用程序中，我们一般都使用服务过滤的方式去捕获和处理异常，这种方式非常常见，而且可用性来说，体验也不错，幸运的是 asp.net core 也完整的支持该方式，接下来创建一个全局异常处理类 customerexceptionfilter

public class customerexceptionfilter : attribute, iexceptionfilter
{
    private readonly ilogger logger = null;
    private readonly ihostingenvironment environment = null;
    public customerexceptionfilter(ilogger<customerexceptionfilter> logger, ihostingenvironment environment)
    {
        this.logger = logger;
        this.environment = environment;
    }

    public void onexception(exceptioncontext context)
    {
        exception exception = context.exception;
        string error = string.empty;

        void readexception(exception ex)
        {
            error += string.format("{0} | {1} | {2}", ex.message, ex.stacktrace, ex.innerexception);
            if (ex.innerexception != null)
            {
                readexception(ex.innerexception);
            }
        }

        readexception(context.exception);
        logger.logerror(error);

        contentresult result = new contentresult
        {
            statuscode = 500,
            contenttype = "text/json;charset=utf-8;"
        };

        if (environment.isdevelopment())
        {
            var json = new { message = exception.message, detail = error };
            result.content = jsonconvert.serializeobject(json);
        }
        else
        {
            result.content = "抱歉，出错了";
        }
        context.result = result;
        context.exceptionhandled = true;
    }
}

customerexceptionfilter 继承自 iexceptionfilter 接口，并实现 void onexception(exceptioncontext context) 方法，在 customerexceptionfilter
构造方法中，定义了两个参数，用于记录异常日志和获取程序运行环境变量

    private readonly ilogger logger = null;
    private readonly ihostingenvironment environment = null;
    public customerexceptionfilter(ilogger<customerexceptionfilter> logger, ihostingenvironment environment)
    {
        this.logger = logger;
        this.environment = environment;
    }

在接下来的 onexception 方法中，利用 environment 进行产品环境的判断，并使用 logger 将日志写入硬盘文件中，为了将日志写入硬盘，
需要引用 nuget 包 nlog.extensions.logging/nlog.web.aspnetcore ，并在 startup.cs 文件的 configure 方法中添加扩展

public void configure(iapplicationbuilder app, ihostingenvironment env, iloggerfactory factory)
        {
            // 将 nlog
            factory.addconsole(configuration.getsection("logging"))
                   .addnlog()
                   .adddebug();

            var nlogfile = system.io.path.combine(env.contentrootpath, "nlog.config");
            env.configurenlog(nlogfile);

            if (env.isdevelopment())
            {
                app.usedeveloperexceptionpage();
            }

            app.usemvc();
        }

上面的代码读取了配置文件 nlog.config 并设置为 nlog 的配置，该文件定义如下

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/nlog.xsd" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" autoreload="true" internalloglevel="info">

  <!-- load the asp.net core plugin -->
  <extensions>
    <add assembly="nlog.web.aspnetcore"/>
  </extensions>

  <!-- layout: https://github.com/nlog/nlog/wiki/layout%20renderers -->
  <targets>
    <target xsi:type="file" name="errorfile" filename="/data/logs/logfilter/error-${shortdate}.log" layout="${longdate}|${logger}|${uppercase:${level}}|  ${message} ${exception}|${aspnet-request-url}" />
    <target xsi:type="null" name="blackhole" />
  </targets>

  <rules>
    <logger name="microsoft.*" minlevel="error" writeto="blackhole" final="true" />
    <logger name="*" minlevel="error" writeto="errorfile" />
  </rules>
</nlog>

为了在 webapi 控制器中使用 customerexceptionfilter 过滤器，我们还需要在 startup.cs 将 customerexceptionfilter 注入到容器中

        // this method gets called by the runtime. use this method to add services to the container.
        public void configureservices(iservicecollection services)
        {
            // 将异常过滤器注入到容器中
            services.addscoped<customerexceptionfilter>();

            services.addmvc()
                .setcompatibilityversion(compatibilityversion.version_2_1);

        }

最后，在控制器 valuescontroller 中应用该异常过滤器

    [servicefilter(typeof(customerexceptionfilter))]
    [route("api/[controller]"), apicontroller]
    public class valuescontroller : controllerbase
    {
        // get api/values
        [httpget]
        public actionresult<ienumerable<string>> get()
        {
            throw new exception("出错了.....");
            return new string[] { "value1", "value2" };
        }
    }

现在，按 f5 启动程序，如预期所料，报错信息被 customerexceptionfilter 捕获，并转换为 json 格式输出

同时，nlog 组件也将日志信息记录到了硬盘中

异常处理方式二：中间件捕获

接下来利用 .netcore 的管道模式，在中间件中对异常进行捕获，首先，创建一个中间件

public class exceptionmiddleware
{
    private readonly requestdelegate next;
    private readonly ilogger logger;
    private ihostingenvironment environment;

    public exceptionmiddleware(requestdelegate next, ilogger<exceptionmiddleware> logger, ihostingenvironment environment)
    {
        this.next = next;
        this.logger = logger;
        this.environment = environment;
    }

    public async task invoke(httpcontext context)
    {
        try
        {
            await next.invoke(context);
            var features = context.features;
        }
        catch (exception e)
        {
            await handleexception(context, e);
        }
    }

    private async task handleexception(httpcontext context, exception e)
    {
        context.response.statuscode = 500;
        context.response.contenttype = "text/json;charset=utf-8;";
        string error = "";

        void readexception(exception ex)
        {
            error += string.format("{0} | {1} | {2}", ex.message, ex.stacktrace, ex.innerexception);
            if (ex.innerexception != null)
            {
                readexception(ex.innerexception);
            }
        }

        readexception(e);
        if (environment.isdevelopment())
        {
            var json = new { message = e.message, detail = error };
            error = jsonconvert.serializeobject(json);
        }
        else
            error = "抱歉，出错了";

        await context.response.writeasync(error);
    }
}

代码比较简单，在管道中使用 try/catch 进行捕获异常，创建 handleexception(httpcontext context, exception e) 处理异常，判断是 development 环境下，输出详细的错误信息，非 development 环境仅提示调用者“抱歉，出错了”，同时使用 nlog 组件将日志写入硬盘；
同样，在 startup.cs 中将 exceptionmiddleware 加入管道中

        // this method gets called by the runtime. use this method to configure the http request pipeline.
        public void configure(iapplicationbuilder app, ihostingenvironment env, iloggerfactory factory)
        {
            // 将 nlog
            factory.addconsole(configuration.getsection("logging"))
                   .addnlog()
                   .adddebug();

            var nlogfile = system.io.path.combine(env.contentrootpath, "nlog.config");
            env.configurenlog(nlogfile);

            // exceptionmiddleware 加入管道
            app.usemiddleware<exceptionmiddleware>();

            //if (env.isdevelopment())
            //{
            //    app.usedeveloperexceptionpage();
            //}

            app.usemvc();
        }

一切就绪，按 f5 运行程序，网页中输出了期望中的 json 格式错误信息，同时 nlog 组件也将日志写入了硬盘

结语

在本例中，通过依赖注入和管道中间件的方式，演示了两种不同的全局捕获异常处理的过程；值得注意到是，两种方式对于 nlog 的使用，都是一样的，没有任何差别，代码无需改动；实际项目中，也是应当区分不同的业务场景，输出不同的
日志信息，不管是从安全或者是用户体验友好性上面来说，都是非常值得推荐的方式，全局异常捕获处理，完全和业务剥离。

努力为开源社区作贡献，推荐一个自己开发的基于 .netcore+pgsql 的快速开发脚手架，内置 orm框架，github地址：
文中如有疏漏之处，欢迎指正。
源码下载：https://files.cnblogs.com/files/viter/ron.logfilter.zip

您可能感兴趣的文章:

如对本文有疑问，请在下面进行留言讨论，广大热心网友会与你互动！！点击进行留言回复

详解.NET Core 3.0 里新的JSON API

为什么需要新的 json api ？json.net 大家都用过，老版本的 asp.net core 也依赖于 json.net 。然而这个依赖就会引起一些版... [阅读全文]
Net Core Web Api项目与在NginX下发布的方法

前言本文将介绍net core的一些基础知识和如何nginx下发布net core的webapi项目。测试环境操作系统：windows 10 开发工具：v... [阅读全文]
浅谈ASP.NET Core 中jwt授权认证的流程原理

1，快速实现授权验证什么是 jwt ？为什么要用 jwt ？jwt 的组成？这些百度可以直接找到，这里不再赘述。实际上，只需要知道 jwt 认证模式是使用一段 ... [阅读全文]
.Net Core 实现图片验证码的实现示例

记录自己的学习，参考了网上各位大佬的技术，往往在登录的时候需要使用到验证码来进行简单的一个校验，这边使用在.net core上进行生成图片二维码思路很简单=》 ... [阅读全文]
asp.net core3.1 引用的元包dll版本兼容性问题解决方案

自从.netcore 3.1出来后，大家都想立马升级到最新版本。我也是如此，微软也对.netcore 3.1 的官方组件不断升级，几乎每隔几天就会有部分元包可以... [阅读全文]
IdentityServer4实现.Net Core API接口权限认证(快速入门)

什么是identityserver4官方解释：identityserver4是基于asp.net core实现的认证和授权框架，是对openid connect... [阅读全文]
从ASP.NET Core3.1迁移到5.0的方法

3月中旬，微软官方已经发布了dotnet 5的第一个预览版：5.0.0-preview.1。dotnet core经过前几个版本的发展和沉淀，到3.1已经基本趋... [阅读全文]
.NET Core中创建和使用NuGet包的示例代码

在.net core的项目中，如果我们要在项目中引用其它dll文件，不建议直接在项目引用中添加dll文件（虽然在.net core项目中也可以这么做），建议是去... [阅读全文]
ASP.NET Core MVC通过IViewLocationExpander扩展视图搜索路径的实现

iviewlocationexpander api expandviewlocations razor视图路径，视图引擎会搜索该路径. populateva... [阅读全文]
ASP.NET Core中的Controller使用示例

asp.net core出现之前我们实现的controller，mvc都继承自controller基类，webapi的话继承自apicontroller。现在a... [阅读全文]