旁白音：本文是不定时更新的.net core，当前主线任务的Nuxt+VueAdmin教程的 nuxt.js 之 tibug项目已上线，大家可以玩一玩：http://123.206.33.109:7090，具体的部署教程会在下周发表。

缘起

哈喽大家周五好呀，今天是一个不定时更新的文章，是很简单的一篇文章，大家应该都能看懂，虽然很简单，但是我感觉很实用，主要包含了两个内容，一个是对AOP编程的进一步的理解（其中还有和过滤器比较），第二个就是一个简单的小插件——记录接口的调用时间调用情况，也就是很简单的性能记录，这个时候你肯定不要和 Metricss+influxdb+grafana 作比较了，它们功能虽然很大，但是用起来笨重，咱们这种入门级别的小项目暂时先不用这个了，说到这里，昨天有小伙伴留言，说要不要在项目中增加消息队列 ReditMQ ，我正在考虑中，看看如何使用，好啦废话不多说，先来几个小问题，热热身：

1、在平时开发的时候，大家是如何记录当前 <接口/方法> 的调用时间的？// 手动写起止时间相减

2、如何对异常进行处理的，这里有 <api层的异常>，以及 <service 层的异常> 的？// 加 try catch

3、如何快速的找到当前接口的错误信息？// 查看日志记录

大家先带着这几个问题自己想一想，是不是和我的绿色解决方案一致，要是有更好的办法也帮忙提给我，不胜感激！

不过！今天肯定不会用这些解决方案的，今天玩儿一个新花样，应该也会有人玩儿过，别着急，咱们往下看。

先来个实现图，预热下，以后调试接口，性能+错误信息一目了然：

image

一、复习篇——我们把AOP用在了哪里？

时间是很快，我也已经从第一个专题，写到了第三个专题，还记得当时第一次写AOP的时候《框架之十 || AOP面向切面编程浅解析：简单日志记录 + 服务切面缓存》，很多很多的小伙伴不是很明白，也不知道应用场景到底在哪里，完全不了解落地几何，现在也能在群里，时不时看到有小伙伴用到AOP编程，感觉很开心，至少帮到了一些人了，这就是最大的欣慰！那咱们在Blog.core 项目中，到底如何运用了 AOP 呢？

1、切面缓存

这一块相信已经有小伙伴知道，并且用到了，我也是在很多地方使用到了，比如在基于策略的权限认证文章中《JWT完美实现权限与接口的动态分配》，通过了对角色模块的切面缓存，很好的实现了快速授权的目的，不仅代码整洁，而且功能也实现了：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> // 将最新的角色和接口列表更新
var data = await _roleModulePermissionServices.GetRoleModule(); var list = (from item in data where item.IsDeleted == false
orderby item.Id select new PermissionItem
{
Url = item.Module?.LinkUrl,
Role = item.Role?.Name,
}).ToList();

// 通过AOP缓存获取角色模块信息
[Caching(AbsoluteExpiration = 10)] public async Task<List<RoleModulePermission>> GetRoleModule()
{ var roleModulePermissions = await dal.Query(a => a.IsDeleted == false); //.......
return roleModulePermissions;
}</pre>

另外还有在当前第三系列教程中，获取Bug信息的时候，也用到了切面缓存（所以，如果你用了文章开头的 tibug 系统，提交了一个 bug，但是没有立刻显示出来，就是这个原因，10分钟缓存）：

image

综上所言，经过多次使用，我个人表示真的是一个神器，在完全不露痕迹的情况下，实现了缓存，是不是很好用？

这个时候你会问，单独为了缓存的话，AOP不是很透彻，那还有其他的用处么？请往下看。前提是上边的这种基于AOP的缓存你要看懂了，先在脑子里回顾下整体流程。

2、切面日志

上边咱们说了缓存，我个人感觉还有一个很大的用户就是切面日志，这个具体的内容以前已经说过了，这里就不多说了，想了解原理和详细说明，请看《AOP面向切面编程浅解析：简单日志记录 + 服务切面缓存》，这里只是复习下流程：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> public void Intercept(IInvocation invocation)
{ //记录被拦截方法信息的日志信息
var dataIntercept = "当前执行方法：{ invocation.Method.Name} "; //在被拦截的方法执行完毕后 继续执行当前方法，注意是被拦截的是异步的
invocation.Proceed();

        dataIntercept += ($"方法执行完毕，返回结果：{invocation.ReturnValue}"); #region 输出到日志文件     
        #endregion }</pre>

只需要我们 ServiceConfigure 中开启服务以后，就可以在指定文件中，看到每次的切面接口调用情况，注意这里是 service 层的，不是 controller 的日志，这个时候就是 AOP 和过滤器 Filter 的区别了：

1、Filter过滤器是基于当前Http请求的，也就是接口层面的，颗粒度比较大；

2、而AOP是基于服务切面的，是 Service 层的请求，颗粒度比较小；

那既然AOP能记录调用日志，能捕获异常么，上次群里有一个小伙伴问到了，这里就点名表扬了，挺棒的，能自己思考，那如何捕获呢？

3、切面异常

在平时的开发中，我们经常会遇到各种 Bug ，在 controller 里的错误就不说了，编译的时候基本都能看出来，但是很多 service 层的错误，真是难找，比如我故意写的这个bug，一个不重要的方法：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> public void NoImportantMethod()
{ int a = 1; int b = 0; int c = a / b;
}</pre>

这个错误是如何捕获的，大家还记得么，就是我们用全局变量异常过滤器 Filter 捕获的《三十五║ 完美实现全局异常日志记录》：

image

我们平时可能会在 api 中使用这样的service层方法，然后下边也会有其他的一些方法，因为这个方法不重要，比如仅仅是阅读数量+1，那我们就不能让当前接口崩了

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> public async Task<MessageModel<Response>> Get()
{ var data = new MessageModel<Response>(); // 一个不重要的方法
_advertisementServices.NoImportantMethod(); // 核心功能：说爱你
Love love = New Love();
love.SayLoveU(); return data;
}</pre>

这个我们我们会在 NoImportantMethod() 这里报异常，直接崩溃出去，你感觉这样的设计合理么？我们不能因为一个不重要的动作就不说核心的 我爱你 了吧😂，所以我们一般就会使用 try catch 的方法，把我们认为会出错的地方包括住，比如这样：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> public async Task<MessageModel<Response>> Get()
{ var data = new MessageModel<Response>(); try{ // 一个不重要的方法
_advertisementServices.NoImportantMethod();
}catch{} // 核心功能：说爱你
Love love = New Love();
love.SayLoveU(); return data;
}</pre>

这样虽然问题解决了，但是总感觉很难受，太丑了，会导致我们所有的接口都写满了这个 try try try，哦no！那咋办么，别慌，还记得我们的AOP记录日志么，既然能记录日志，照样能记录异常！

没错就是这里：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> try {
invocation.Proceed();
} catch (Exception e)
{//执行的 service 中，捕获异常
dataIntercept += ($"方法执行中出现异常：{e.Message + e.InnerException}");
}</pre>

我们看看效果：

image

然后很顺利的捕获到了异常，并且主程序也走了下去，我们就可以找到我们的日志文件，然后看看错误：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;">20190118 11:40:50 当前执行方法：ReturnExp 参数是：
方法执行中出现异常：Attempted to divide by zero.方法执行完毕，返回结果：</pre>

到这里！我们的文章开头提问的第二个方法（如何对异常进行处理的）已经顺利解决！我现在在公司的项目中就是用的这种切面方法，来进行处理的，把那些不重要的方法给走下去，虽然可能会出现，提交了订单，但是一直提交不上的问题，但是至少保证不会让页面崩了的尴尬情况。

到了这里不知道你是否满意了呢，别慌，刚刚我们是如何来查看错误的？是通过找日志是吧，然后还需要对应的时间呀，接口方法呀啥的，如果日志信息很多，那茫茫bug，如何找到你心仪的那一个呢，这样，文章开头的第三问就出来了，这里先不说第三个，先说下第一个问题（如何记录当前 <接口/方法> 的调用时间）。请往下看。

二、接口执行时间分析——MiniProfiler

1、平时我们的是如何测接口时间的

A：我们平时在开发接口的时候，总想看看一个接口到底执行了多久，甚至想看看某一个service 方法执行了多长时间，这个时候，我以前都是通过 断点调试的方法，来看执行时间，比如这样：

image

（这里说下我用的 Sqlsugar 的批量添加，100条，0.4s，速度还行，因为我中间还有一个if操作，所以时间应该在0.3左右，给凯旋兄打给广告😀）

B：或者直接就是写个起止时间方法，来判断下，比如这样（图片来自群管理DX）：

image

但是我们有那么多的接口，那么多的方法，总不能都这么 Debug 调试吧，也不能都写个方法吧，

C：我们可以使用AOP来进行每次方法的时间记录

就算是用上边的 AOP 写了一个，还是得查看日志不是，而且也只能是service层的，那api层还得写过滤器了，这个时候，有一个插件可以帮我们省去查看日志的诟病，就是它——MiniProfiler，这个具体的功能呢，我就不说了，大家自行百度即可，就是一个小插件，我这里就说下如何使用：

2、如何使用 MiniProfiler

使用方法很简单，首先我们需要引入nuget包：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> Install-Package MiniProfiler.AspNetCore.Mvc</pre>

然后，在startup.cs 中配置服务ConfigureServices：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> services.AddMiniProfiler(options => {
options.RouteBasePath = "/profiler";//注意这个路径要和下边 index.html 脚本配置中的一致，
(options.Storage as MemoryCacheStorage).CacheDuration = TimeSpan.FromMinutes(10);

  }</pre>

最后，调用下中间件即可：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> app.UseMiniProfiler();</pre>

当前这个时候还不能使用，我们还需要在 Swagger 中进行配置，以便它能在 swagger 中使用。

3、在 Swagger 中配置 MiniProfiler

上边我们在配置中已经启动了服务，接下来就需要设置如何在 swagger 中展示了，这个时候我们就需要自定义我们的swagger主页了，以前我们是用的默认的index.html，现在咱们需要自定义一个：

从官网 Github 上，下载最新的 index.html：https://github.com/swagger-api/swagger-ui/blob/master/dist/index.html(官方的应该是这个，和我的有一丢丢不一样，应该也可以用)

然后添加到项目中，我是放到了根路径了：

image

这个时候记得要把这个文件设置成嵌入资源的类型：

image

接下来，在 Index.html 文件中，增加配置脚本（我是在顶部写的，Head应该也可以，其他的没实验）：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"><script async="async" id="mini-profiler" src="/profiler/includes.min.js?v=4.0.138+gcc91adf599" data-version="4.0.138+gcc91adf599" data-path="/profiler/" data-current-id="4ec7c742-49d4-4eaf-8281-3c1e0efa748a" data-ids="" data-position="Left" data-authorized="true" data-max-traces="15" data-toggle-shortcut="Alt+P" data-trivial-milliseconds="2.0" data-ignored-duplicate-execute-types="Open,OpenAsync,Close,CloseAsync">
</script>

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"> ........
........</pre>

具体的参数请自行研究吧，基本都能看懂，比如版本，/profiler的路径，position的位置显示（我是左边），authorized的是否权限，max-traces最多显示多少条（15）等等。

然后我们修改下中间件去调用我们这个 index.html 页面：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;">app.UseSwaggerUI(c => { typeof(ApiVersions).GetEnumNames().OrderByDescending(e => e).ToList().ForEach(version => {
c.SwaggerEndpoint("{ApiName} {version}");
});
// 将swagger首页，设置成我们自定义的页面，记得这个字符串的写法：解决方案名.index.html
c.IndexStream = () => GetType().GetTypeInfo().Assembly.GetManifestResourceStream("Blog.Core.index.html");

});</pre>

最后，记得一定要配置了使用静态资源文件的中间件：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> app.UseStaticFiles();</pre>

好啦，现在已经配置好了 MiniProfiler 和 Swagger了，最后就是如何使用了：

4、在接口中使用 MiniProfiler

这里我在BlogController 的Get方法中，使用：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> public async Task<object> Get(int id, int page = 1, string bcategory = "技术博文")
{
...... // 你可以用这种包括的形式
using (MiniProfiler.Current.Step("开始加载数据："))
{ if (redisCacheManager.Get<object>("Redis.Blog") != null)
{ // 也可以直接这么写
MiniProfiler.Current.Step("从Redis服务器中加载数据：");
blogArticleList = redisCacheManager.Get<List<BlogArticle>>("Redis.Blog");
} else {
MiniProfiler.Current.Step("从MSSQL服务器中加载数据：");
blogArticleList = await blogArticleServices.Query(a => a.bcategory == bcategory);
redisCacheManager.Set("Redis.Blog", blogArticleList, TimeSpan.FromHours(2));
}
}
......
}</pre>

最后的效果就是这样的(这里说明下：我有时候在F5启动项目，然后第一次点击某一个接口的时候，当前接口分析报告会没有，再点击这个接口，报告就好了，情况以后也不会出现了，如果你也遇到了不要慌，属于正常问题)：

image

是不是感觉挺好的！这样的时间都有了，然后还记得上边配置的 /profiler 么，我们点击 share 就能看到了，这里不细说了，大家自己玩一玩。现在有一个问题就是，我总不能每一个 api 接口都这么写吧，多麻烦呀！机智如你，这个时候 AOP 日志记录又派上用场了！

5、切面 MiniFilter 分析

很简单，只需要在 AOP 日志记录中，配置 MiniProfiler 即可：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> try { // 就是这里！！
MiniProfiler.Current.Step($"执行Service方法：{invocation.Method.Name}() -> ");

 invocation.Proceed();

} catch (Exception e)
{ //执行的 service 中，捕获异常
dataIntercept += ($"方法执行中出现异常：{e.Message + e.InnerException}");
}</pre>

这样就在任何的接口中，都能看到这个调用信息了！

image

是不是现在更加体会到了 AOP 的好处！

就这样，咱们文章开头的第一个问题就这样解决啦！目前是第一、第二两个问题都解决了，就剩下第三个问题了，如果查看错误日志呢，目前我们还是在日志里查看的，别慌，虽然 MiniProfiler没有这个功能，但是我自己奇思妙想了一个，请往下看。

6、在Swagger中展示 Sql 执行日志

操作很简单，功能很有效，动图如下，具体的看我的在线地址 http://123.206.33.109:8081：

image

如果想要开启这个 SQL AOP的功能，请参考我的源代码，主要是通过 SqlSugar 的 相关功能来实现：

Blog.Core.Repository -> DbContext.cs -> _db.Aop.OnLogExecuting

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> _db.Aop.OnLogExecuting = (sql, pars) => //SQL执行中事件
{
Parallel.For(0, 1, e => {
MiniProfiler.Current.CustomTiming("SQL：", GetParas(pars) + "【SQL语句】：" + sql);
LogLock.OutSql2Log("SqlLog", new string[] { GetParas(pars), "【SQL语句】：" + sql });

 });

};</pre>

三、结合AOP+MiniProfiler实现异常可视化

刚刚上边咱们也说到了，可以使用 AOP 进行异常的捕获记录，只不过需要在 log 日志文件中，查看。而 miniprofiler 的功能竟然正好是时间的分析展示，那我们可不可以融合下两者呢！

很简单！我们只需要在 AOP 的切面异常catch中，还有 全局Filter 异常中，将错误信息融入到 MiniProfiler即可：

<pre style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;">// 这个是AOP中
try {
MiniProfiler.Current.Step("方法执行中出现异常：{e.Message + e.InnerException}");
}

//这个是全局异常处理中
public void OnException(ExceptionContext context)
{
//...................不重要内容...............

 MiniProfiler.Current.CustomTiming("Errors：", json.Message); //采用log4net 进行错误日志记录

_loggerHelper.Error(json.Message, WriteLog(json.Message, context.Exception));

}</pre>

这个时候，我们查看下效果，还记得上边咱们说到的那个栗子么，就是为了一个不重要的方法，而不能说出核心功能 “我爱你” 的那个栗子，咱们现在再看看效果：

image

是不是很方便！不仅能查看出所有的接口调用时间记录，还能查看错误信息！这对于我们平时开发还是很有帮助的！

文章开头的第三个问题（如何快速的找到当前接口的错误信息）也完美解决！

四、结语

好啦，今天的讲解就到这里了，主要说了分析了AOP切面编程的大作用，然后讲解了 MiniProfiler 插件的使用，同时对异常的处理，极大的帮助开发者定位错误已经信息处理。

最后给大家说下，关于Miniprofilter 还有其他的情景：

1、可以针对 EF 对数据库sql执行的性能进行监控（因为本项目是Sqlsugar，所以就不针对性展示了，想实验的可以自行测试）。

• 首先修改Client solution， 添加 Dbcontext、Models、Repository
• Nuget安装packageMiniProfiler.EntityFrameworkCore
• Startup类的方法ConfigureServices添加代码：

<pre class="hljs css" style="color: rgb(0, 0, 0); font-family: "Courier New"; font-size: 12px; margin: 5px 8px; padding: 5px;"> services.AddMiniProfiler().AddEntityFramework(); </pre>

• 然后在 Controller 的 Index 方法中添加对 repository 方法的调用

2、不需要一定在swagger中使用，其他的也行，比如mvc，只不过我感觉swagger更舒服。

五、Github & Gitee

https://github.com/anjoy8/Blog.Core

https://gitee.com/laozhangIsPhi/Blog.Core

-- ♥ -- ♥ -- ♥ -- ♥ -- ♥ -- ♥ --