ABP VNext + Fody AOP：编译期织入与性能监控

ABP VNext + Fody AOP：编译期织入与性能监控 🚀

1. 引言 💡

TL;DR
用 Fody + MethodDecorator.Fody 在编译期为 ABP ApplicationService 自动注入：日志、耗时计时、异常捕获。

• ⚡ 极少反射/零侵入：仅在切面初始化时使用少量反射获取方法信息；不依赖运行时动态代理。
• 🛠 支持 同步/异步 方法；可与 ABP 模块化/DI 并存。
• 📊 附 BenchmarkDotNet 对比，量化织入开销。

为什么不是运行时 AOP？
运行时代理（Castle DynamicProxy）会引入启动延迟、调用额外开销，还可能和第三方拦截器冲突；编译期 IL 织入更轻、更可控。

2. 环境与依赖 🛠

• 平台：.NET 6.x、ABP v6.x

• NuGet 包

  dotnet add package Fody
  dotnet add package MethodDecorator.Fody
  dotnet add package Serilog
  dotnet add package Serilog.Extensions.Hosting
  dotnet add package Serilog.Sinks.Console
  dotnet add package BenchmarkDotNet
  

• 注意

  • 📂 FodyWeavers.xml 放在项目根目录（与 .csproj 同级）。

  • 推荐 .csproj 配置：

    <PropertyGroup>
      <LangVersion>latest</LangVersion>
      <Nullable>enable</Nullable>
    </PropertyGroup>
    
    <ItemGroup>
      <PackageReference Include="Fody" Version="*" PrivateAssets="all" />
      <PackageReference Include="MethodDecorator.Fody" Version="*" PrivateAssets="all" />
    </ItemGroup>
    

3. 启用 Fody（项目配置） ⚙️

FodyWeavers.xml 示例（限制织入范围，防止误伤）：

<?xml version="1.0" encoding="utf-8" ?>
<Weavers>
  <MethodDecorator>
    <IncludeAssemblies>MyCompany.MyApp.Application|MyCompany.MyApp.Domain</IncludeAssemblies>
    <ExcludeAssemblies>Volo.Abp.*|Castle.*</ExcludeAssemblies>
  </MethodDecorator>
</Weavers>

📊 编译期织入流程

4. 编译期切面 Attribute 🔍

日志 + 性能计时 + 异常捕获

using MethodDecorator.Fody.Interfaces;
using System;
using System.Diagnostics;
using System.Reflection;
using Serilog;

[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class | AttributeTargets.Assembly, AllowMultiple = false)]
public sealed class LogPerformanceAttribute : Attribute, IMethodDecorator
{
    private Stopwatch? _sw;
    private string _methodName = string.Empty;
    private readonly ILogger _log;

    private const int SlowThresholdMs = 200; // 可改为从配置读取

    public LogPerformanceAttribute()
    {
        _log = Log.ForContext<LogPerformanceAttribute>();
    }

    public void Init(object instance, MethodBase method, object[] args)
    {
        _methodName = $"{method.DeclaringType?.Name}.{method.Name}";
    }

    public void OnEntry()
    {
        _sw = Stopwatch.StartNew();
        _log.Debug("🚀 [Enter] {Method}", _methodName);
    }

    public void OnExit()
    {
        if (_sw == null) return;
        _sw.Stop();

        var elapsed = _sw.ElapsedMilliseconds;
        if (elapsed >= SlowThresholdMs)
            _log.Warning("🐢 [Slow] {Method} took {Elapsed} ms", _methodName, elapsed);
        else
            _log.Information("✅ [Exit] {Method} in {Elapsed} ms", _methodName, elapsed);
    }

    public void OnException(Exception exception)
    {
        _sw?.Stop();
        _log.Error(exception, "💥 [Error] {Method}", _methodName);
    }
}

⚠ 注意：async void 方法无法保证触发 OnExit()，不建议织入此类方法。

📊 方法调用运行流程

5. 应用范围 🎯

• 程序集级别：

  [assembly: LogPerformance]
  

• 类级别：

  [LogPerformance]
  public class ProductAppService : ApplicationService { }
  

• 方法级别：

  public class OrderAppService : ApplicationService
  {
      [LogPerformance]
      public async Task<OrderDto> GetAsync(Guid id) { /* ... */ }
  }
  

💡 建议仅对 Application 层 织入，避免与 ABP 审计/日志拦截器重复打点。

6. Serilog 接入 📜

using Serilog;

Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Information()
    .WriteTo.Async(a => a.Console())
    .Enrich.FromLogContext()
    .Enrich.WithEnvironmentName()
    .CreateLogger();

try
{
    builder.Host.UseSerilog();
}
finally
{
    Log.CloseAndFlush();
}

初始化时机要在 HostBuilder 创建之前，避免被 ABP 默认日志覆盖。

7. 阈值配置化 🎚

public static class AopSettings
{
    public static int SlowThresholdMs { get; private set; } = 200;
    public static void Load(IConfiguration config)
        => SlowThresholdMs = config.GetValue<int?>("AopMonitoring:SlowThresholdMs") ?? 200;
}

AopSettings.Load(builder.Configuration);

8. Benchmark 测试 🏎

using BenchmarkDotNet.Attributes;
using BenchmarkDotNet.Running;
using BenchmarkDotNet.Order;

[SimpleJob(BenchmarkDotNet.Jobs.RuntimeMoniker.Net80)]
[MemoryDiagnoser]
[Orderer(SummaryOrderPolicy.FastestToSlowest)]
[IterationCount(20)]
public class PerfTests
{
    private readonly ProductAppService _svc = new();

    [Benchmark(Baseline = true)]
    public Task NoAop_GetAsync() => _svc.GetAsync(Guid.NewGuid());

    [Benchmark]
    public Task FodyAop_GetAsync() => _svc.GetAsync(Guid.NewGuid());
}

public static class Program
{
    public static void Main() => BenchmarkRunner.Run<PerfTests>();
}

public class ProductAppService
{
    public virtual Task<int> GetAsync(Guid id) => Task.FromResult(42);
}

测试方法：

1. 关闭织入 → 编译 → 运行 Benchmark
2. 开启织入 → 编译 → 运行 Benchmark
3. 对比吞吐/耗时差异 📊

9. 常见问题与规避 ⚠

• 冲突：用 IncludeAssemblies 限制范围，或关闭 ABP 某些拦截器。
• 日志风暴：使用阈值日志、方法白名单。
• 调试策略：Debug 全织入，Release 精准织入。
• AOT/Trim 注意：NativeAOT 或裁剪发布时，需要保留反射元数据，否则 MethodBase 获取可能失效。