函数拦截器实现无侵入aop日志系统，关键在于编译期重写而非运行时代理，依托c# 12+的[interceptslocation]精准绑定源码坐标，通过静态拦截方法注入日志逻辑，并统一封装结构化输出与上下文信息。

函数拦截器实现无侵入 AOP 日志系统，关键在于**不修改业务代码、不引入运行时代理、不依赖反射**，而是借助编译期重写机制，把日志逻辑“静默织入”到目标调用点。C# 12+ 的 [InterceptsLocation] 拦截器正是为此而生——它不是运行时钩子，而是编译器在生成 IL 前就完成的调用替换。

明确拦截位置：精准绑定到源码坐标

拦截器必须指向一个真实存在的方法调用语句，且需精确到文件名、行号和列偏移。这确保了注入行为可追溯、可调试、不模糊。

• 使用 [InterceptsLocation("Program.cs", 15, 8)] 明确声明要拦截 Program.cs 第 15 行第 8 列的调用
• 被拦截的原始方法（如 LogCallSite()）本身可以是空壳或占位符，仅作语法锚点
• 编译器会校验该位置是否确实存在一次方法调用，否则报错，保障类型安全

定义拦截逻辑：静态方法 + 兼容签名

拦截器方法必须是 public static，参数和返回值需与原始调用兼容。它可以执行日志、计时、审计等横切逻辑，并可选择是否继续原逻辑。

• 例如拦截 OrderService.Process() 调用，拦截器签名应为 public static void ProcessInterceptor(Order order)
• 若需记录耗时，可在拦截器中调用 Stopwatch.StartNew()，再通过隐式插入的 next() 或编译器自动委托执行原方法
• 金融级场景中，还可嵌入风控检查、硬件时间戳审计等强约束逻辑

统一日志封装：避免散落式埋点

把日志格式、上下文（如 TraceId、UserId）、序列化策略等收口到拦截器内部，业务层完全不感知日志存在。

• 拦截器内可读取 [CallerMemberName]、[CallerLineNumber] 自动补全调用元信息
• 支持结构化输出（如 JSON 字段），便于 ELK 或 OpenTelemetry 接入
• 通过条件编译符号（如 #if LOG_ENABLED）控制拦截器是否参与编译，实现环境差异化开关

验证与调试：保持透明性与可控性

区别于传统 AOP 框架生成不可见代理类，拦截器织入后的代码仍保留在源生成阶段可见，调试体验接近原生。

• 启用 /source-generators:log 编译选项可查看生成的中间代码
• 断点既可打在拦截器方法上，也可打在原始调用行——IDE 会自动映射到实际执行路径
• 若某处调用未被拦截，编译器不会报错，但原始方法照常执行，行为退化安全