quarkus 的 cdi 拦截器仅支持 public、protected 和包级私有（default）方法，不支持 private 方法；尝试拦截私有方法将被静默忽略（或构建失败），但静态非私有方法可被拦截。
quarkus 的 cdi 拦截器仅支持 public、protected 和包级私有（default）方法，不支持 private 方法；尝试拦截私有方法将被静默忽略（或构建失败），但静态非私有方法可被拦截。
在 Quarkus 中，拦截器（Interceptor）是基于 CDI（Contexts and Dependency Injection）规范实现的运行时增强机制，其底层依赖字节码增强（如 Javassist 或 Byte Buddy）和代理模式。关键限制在于：Java 代理和大多数字节码操作框架无法安全、可靠地重写或拦截 private 方法——因为 private 方法不具备继承性，无法被子类覆写，代理类无法通过常规方式委托调用。
因此，Quarkus 明确规定：
✅ 支持拦截的方法可见性：
- public 方法（最常用）
- protected 方法
- 包级私有（即无访问修饰符，default）方法
❌ 不支持拦截的方法：
- private 方法（无论是否在同一个类中）
- final 方法（因无法被代理覆写）
⚠️ 注意：默认情况下，若在 private 方法上声明了拦截器绑定（如 @Logged），Quarkus 在构建阶段会静默忽略该拦截器，不会报错，也不会生效。为避免隐蔽缺陷，建议启用严格校验：
# application.properties quarkus.arc.fail-on-intercepted-private-method=true
启用后，构建时将立即失败并提示类似错误：
Build failure: Interceptor binding @Logged cannot be applied to private method 'void com.example.MyService.doInternal()'
✅ 可行的替代方案
方案 1：提升方法可见性（推荐）
将私有逻辑提取为包级私有或 protected 方法，并确保其所在类由 CDI 管理（如添加 @ApplicationScoped）：
基于夸克网盘自动转存项目 QAS 的懒人追剧、追番 SKILL，内置 CLI 工具。即使 QAS 订阅失效，仍可重新搜索资源、遍历多级目录，在多个最新候选中按用户偏好（如更高清晰度）转存新集和缺失集。可交由本地 OpenClaw、Hermes Agent 或其他 Claude 客户端使用。
@ApplicationScoped
public class OrderService {
// ✅ 可被拦截的包级私有方法
@Logged // 自定义拦截器
void processOrderInternal(Order order) {
// 耗时业务逻辑
Thread.sleep(100);
}
// 公共入口，调用内部可拦截方法
public void processOrder(Order order) {
processOrderInternal(order); // 拦截器在此生效
}
}方案 2：使用静态非私有方法（需显式启用）
Quarkus 从 2.7+ 支持对 static non-private 方法的拦截（需配置）：
# application.properties quarkus.arc.intercept-static-methods=true
@ApplicationScoped
public class MetricsUtils {
@Timed // 自定义计时拦截器
public static void recordLatency(String op) { // 必须是 public static
System.out.println("Timing: " + op);
}
}? 注意：静态方法拦截不经过 CDI 上下文（无依赖注入、无事务上下文等），适用于工具类场景，不适用于需依赖注入的业务逻辑。
方案 3：手动调用拦截逻辑（兜底方案）
若必须保留 private 方法，可在方法内部显式调用日志/监控逻辑：
private void doCriticalWork() {
long start = System.nanoTime();
try {
// 核心逻辑
} finally {
long elapsed = System.nanoTime() - start;
LOG.info("doCriticalWork took {} ms", TimeUnit.NANOSECONDS.toMillis(elapsed));
}
}但此方式失去 AOP 的横切解耦优势，应作为最后选择。
总结
- 不要尝试在 private 方法上使用 @InterceptorBinding —— 它不会生效，且易引发维护陷阱；
- 优先重构为 package-private 或 protected 方法，配合 CDI 代理实现真正的声明式拦截；
- 合理启用 quarkus.arc.fail-on-intercepted-private-method=true，让问题暴露在编译期而非运行时；
- 静态方法拦截是补充能力，但适用场景有限，不可替代标准实例方法拦截。
遵循这些实践，既能保障拦截器的可靠性，又能保持代码的可测试性与可维护性。
