Guice Method Interceptor未生效问题排查求助

看起来你遇到了Guice方法拦截器不生效的问题，我先从你的代码里发现几个关键问题，再逐一分析可能的原因：

1. 最直接的错误：bindInterceptor调用缺少拦截器实例 #

你的MetricsModule里的bindInterceptor调用只传了类匹配器和方法匹配器，但漏掉了要绑定的拦截器实例！Guice需要明确知道要把哪个拦截器关联到匹配的方法上。

修正后的MetricsModule应该是这样：

public class MetricsModule extends AbstractModule { 
    @Override protected void configure() { 
        // 第三个参数必须传入拦截器的实例（或者绑定的类型）
        bindInterceptor(any(), annotatedWith(PublishMetric.class), new PublishMetricInterceptor());
    }
}

如果希望拦截器本身也由Guice管理（比如它有依赖需要注入），可以先绑定拦截器，再引用它：

public class MetricsModule extends AbstractModule { 
    @Override protected void configure() { 
        // 先绑定拦截器到Guice容器
        bind(PublishMetricInterceptor.class);
        // 然后通过Provider获取或者直接传入类型（Guice会自动注入）
        bindInterceptor(any(), annotatedWith(PublishMetric.class), getProvider(PublishMetricInterceptor.class));
    }
}

2. 其他可能导致拦截器不生效的原因 #

如果修正了上面的问题后还是没效果，检查以下几点：

• 被注解的类是否由Guice创建？
  Guice的方法拦截器只对由Guice容器实例化的类生效。如果你是通过new关键字直接创建类实例，而不是通过Injector.getInstance()或者依赖注入获取的，Guice无法为这个类生成代理，拦截器自然不会触发。

  错误示例：

  // 这种方式创建的实例，拦截器不会生效
  MyService service = new MyService();
  

  正确示例：

  Injector injector = Guice.createInjector(new MetricsModule());
  MyService service = injector.getInstance(MyService.class);
  

• 目标类或方法是不是final的？
  Guice默认使用JDK动态代理（针对接口）或者CGLIB代理（针对类），但final类或者final方法无法被代理，拦截器也就无法切入。确保你的目标类和被@PublishMetric注解的方法都不是final的。

• 模块是否被正确安装到Injector中？
  确认你创建Injector的时候，确实把MetricsModule加进去了：

  Injector injector = Guice.createInjector(new MetricsModule()); // 必须包含这个模块
  

• 注解的匹配是否正确？
  检查你的@PublishMetric注解是否确实标注在实例方法上（不是静态方法，Guice拦截器不支持静态方法），并且注解的@Target确实包含ElementType.METHOD（你的代码里是对的，但可以再确认一下）。

现在你可以先修正bindInterceptor的调用，然后逐一排查上面的点，应该就能解决问题了。

内容的提问来源于stack exchange，提问作者Vaishal