如何在Spring Boot XML文件中注册Servlet？含Bean方式注册方法

阿华AIGC实验室

2026-5-26

嘿，我来帮你搞定这个问题！你现在的情况是想把自定义的HttpServlet既纳入Spring Bean管理，又给它指定访问路由对吧？之前用代码直接调用contextHandler.addServlet能正常跑，但用beans.xml把它注册成Bean后，就没了路由映射，对吧？

下面给你几种可行的方案，你可以根据自己的偏好选：

方案1：用Java配置类结合`ServletRegistrationBean`

这种方式是Spring Boot推荐的做法，既能把Servlet变成Bean，又能灵活配置路由：

@Configuration
public class CustomServletConfig {
    // 先把你的MyClass注册为Spring Bean
    @Bean
    public MyClass myClassServlet() {
        return new MyClass();
    }

    // 再用ServletRegistrationBean绑定路由和Servlet实例
    @Bean
    public ServletRegistrationBean<MyClass> myClassRegistration() {
        ServletRegistrationBean<MyClass> registration = new ServletRegistrationBean<>(myClassServlet(), "/v1/route");
        // 可选：设置启动优先级，数字越小越先加载
        registration.setLoadOnStartup(1);
        return registration;
    }
}

这样一来，MyClass既是Spring容器里的Bean，又被映射到了/v1/route路径，和你之前用contextHandler.addServlet的效果完全一致。

方案2：用注解简化配置

如果你不想写配置类，可以用注解组合的方式：

先给你的MyClass加上@Component（让它成为Spring Bean）和@WebServlet（指定路由）：

@Component
@WebServlet(urlPatterns = "/v1/route")
public class MyClass extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 你的业务逻辑
    }
}

然后在Spring Boot的启动类上加上@ServletComponentScan，让Spring自动扫描并注册带@WebServlet的类：

@SpringBootApplication
@ServletComponentScan
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

方案3：坚持用XML配置（beans.xml）

如果你更习惯XML配置，也可以这么写：

<!-- 先注册MyClass为Spring Bean -->
<bean id="myId" class="com.abc.MyClass"/>

<!-- 用ServletRegistrationBean绑定路由和Bean实例 -->
<bean class="org.springframework.boot.web.servlet.ServletRegistrationBean">
    <!-- 第一个构造参数：关联上面的MyClass Bean -->
    <constructor-arg ref="myId"/>
    <!-- 第二个构造参数：指定访问路由 -->
    <constructor-arg value="/v1/route"/>
    <!-- 可选配置：启动加载优先级 -->
    <property name="loadOnStartup" value="1"/>
</bean>

为啥直接注册Bean不行？

简单说：你直接在beans.xml里注册MyClass，Spring只是把它当成普通的Bean管理，但不会自动把它注册到Servlet容器里。而ServletRegistrationBean就相当于你之前用的contextHandler.addServlet，它负责把Spring管理的Servlet实例绑定到指定路由，并注册到Servlet容器中。

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