Spring Boot部署报错：找不到名为'metricFilter'的Bean

我太懂这种老环境适配的痛苦了——Spring Boot 1.x搭配Servlet 2.5的WebLogic，各种兼容性坑层出不穷。咱们一步步来解决你的问题：

先拆解问题根源 #

你遇到的两个问题其实是连锁反应：

• 注释metricFilter后Tomcat能跑但WebLogic炸：WebLogic对Servlet 2.5的规范执行比Tomcat严格，加上spring-boot-legacy的适配有局限性，导致注释Filter后还是有未兼容的配置残留；
• 恢复注释后Tomcat报错找不到Bean：说明你只在配置里声明了Filter的注册逻辑，但对应的metricFilter Bean根本没被Spring容器正确实例化（或者名字不匹配）。

具体解决步骤 #

1. 确保metricFilter Bean被正确定义并命名

先检查你的配置，必须显式创建名为metricFilter的Bean，Spring才能找到它：

• 如果用Java配置类，直接指定Bean名称：

@Bean(name = "metricFilter")
public MetricsFilter metricFilter() {
    // 这里用Spring Boot 1.4.x Actuator自带的MetricsFilter，别导错包
    MetricsFilter filter = new MetricsFilter();
    // 可以根据需求添加配置，比如设置metric名称前缀等
    return filter;
}

• 如果用XML配置，保证bean的id是metricFilter：

<bean id="metricFilter" class="org.springframework.boot.actuate.metrics.web.filter.MetricsFilter"/>

划重点：Bean的名字必须和你Filter注册时用的filter-name完全一致，否则Spring找不到。

2. 用Servlet 2.5兼容的方式注册Filter

因为WebLogic 10.3不支持Servlet 3.0的注解式Filter注册，所以必须在web.xml里手动注册，而且要用DelegatingFilterProxy来关联Spring容器里的Bean：

<filter>
    <filter-name>metricFilter</filter-name>
    <!-- 用DelegatingFilterProxy转发到Spring容器里的Bean -->
    <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
    <init-param>
        <!-- 明确指定要找的Bean名称，避免歧义 -->
        <param-name>targetBeanName</param-name>
        <param-value>metricFilter</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>metricFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

这种方式既兼容Servlet 2.5，又能保证Filter和Spring上下文完全整合。

3. 禁用Spring Boot的自动MetricsFilter配置

Spring Boot 1.4.x的Actuator会自动注册MetricsFilter，但在Servlet 2.5环境下这个自动配置会失效，还会和你手动配置冲突。所以直接禁用它：

@SpringBootApplication
// 排除自动的MetricsFilter配置类
@EnableAutoConfiguration(exclude = {MetricsFilterAutoConfiguration.class})
public class YourApp extends SpringBootServletInitializer {
    // 你的应用代码
}

这样就能彻底避免自动配置和手动配置的冲突。

4. 给WebLogic加类加载适配

WebLogic自带了一堆老版本的类，很容易和你应用里的类冲突，必须在weblogic.xml里设置优先加载WEB-INF里的类：

<weblogic-web-app xmlns="http://xmlns.oracle.com/weblogic/weblogic-web-app">
    <container-descriptor>
        <!-- 让WebLogic优先用应用自带的类，避免版本冲突 -->
        <prefer-web-inf-classes>true</prefer-web-inf-classes>
    </container-descriptor>
</weblogic-web-app>

这一步是WebLogic适配的必选项，很多莫名其妙的启动异常都是类加载顺序导致的。

验证流程 #

1. 先在Tomcat 7上测试：按照上面的配置调整后，取消metricFilter的注释，启动应用，确认不再报NoSuchBeanDefinitionException；
2. 再部署到WebLogic：带上调整后的web.xml和weblogic.xml，启动应用，检查日志是否正常初始化metricFilter，没有异常。

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