C#中实现AOP最成熟轻量的方案是Castle DynamicProxy,它通过运行时代理生成实现方法拦截,支持接口和类代理,需实现IInterceptor接口并调用invocation.Proceed()执行原方法。

在C#中实现AOP(面向切面编程),最成熟、轻量且广泛使用的方案是 Castle DynamicProxy。它不依赖编译器或IL修改,纯运行时通过代理生成实现方法拦截,适合日志、权限、事务、缓存等横切关注点。
一、安装与基础准备
使用 NuGet 安装核心包:
- Castle.Core(含 DynamicProxy 实现)
注意:不需要安装 Castle.Windsor(那是IOC容器,和AOP无关)。项目支持 .NET Standard 2.0+ 或 .NET 5/6/7/8 均可。
二、定义拦截器(IInterceptor)
所有切面逻辑都封装在自定义拦截器中,必须实现 IInterceptor 接口:
public class LoggingInterceptor : IInterceptor
{
public void Intercept(IInvocation invocation)
{
Console.WriteLine($"【开始】{invocation.Method.Name}");
try
{
invocation.Proceed(); // 执行原方法
Console.WriteLine($"【成功】{invocation.Method.Name} → {invocation.ReturnValue}");
}
catch (Exception ex)
{
Console.WriteLine($"【异常】{invocation.Method.Name} → {ex.Message}");
throw; // 不吞异常,保持行为一致
}
}
}
关键点:
- invocation.Proceed() 必须调用,否则原方法不会执行
- 可读写 invocation.Arguments 和 invocation.ReturnValue
- 支持同步/异步拦截(需配合 IAsyncInterceptor,.NET Core 3.0+)
三、为类或接口创建代理
DynamicProxy 支持两种代理方式,适用场景不同:
- 接口代理:目标类实现接口,用 CreateInterfaceProxyWithTarget(推荐,无侵入)
- 类代理:目标类需有虚方法(virtual),用 CreateClassProxyWithTarget
示例(接口方式):
public interface IService
{
string DoWork();
}
public class ServiceImpl : IService
{
public virtual string DoWork() => "done";
}
// 创建代理
var proxyGenerator = new ProxyGenerator();
var interceptor = new LoggingInterceptor();
var target = new ServiceImpl();
var proxy = proxyGenerator.CreateInterfaceProxyWithTarget(target, interceptor);
Console.WriteLine(proxy.DoWork()); // 触发拦截器
四、进阶技巧与注意事项
实际项目中常遇到的问题和解法:
- 多个拦截器:按添加顺序执行,传入数组:new[] { logInter, authInter }
-
按方法名/特性过滤:在 Intercept 中检查 invocation.Method.GetCustomAttribute
() - 避免代理“密封类”或“非虚方法”:类代理失败会静默回退到目标对象(无拦截),建议开启调试日志或单元测试验证
- 生命周期管理:拦截器实例通常应是单例(如 LoggingInterceptor 无状态),避免在拦截器里持有上下文引用导致内存泄漏
基本上就这些。DynamicProxy 不复杂但容易忽略细节——重点是选对代理方式、确保方法可被拦截、拦截器别吞异常。用熟之后,搭配 DI 容器(如 Microsoft.Extensions.DependencyInjection)自动注入代理,就能无缝集成到业务中。











