Spring MVC RestController 404排查：请求/api/hello资源不可用

数据老陈

2026-8-2

Spring MVC "Hello World" 404错误排查

我尝试用Spring MVC编写一个简单的Hello World应用，发送GET请求/api/hello时始终返回404错误：“请求的资源[/api/hello]不可用”。使用IntelliJ IDEA 2022.2.2（旗舰版），服务器为Tomcat 9.0.71。

我的代码

控制器类

package org.example.rest.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class MyRestController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello";
    }
}

配置类

package org.example.rest.configuration;

import com.mchange.v2.c3p0.ComboPooledDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.orm.hibernate5.HibernateTransactionManager;
import org.springframework.orm.hibernate5.LocalSessionFactoryBean;
import org.springframework.transaction.annotation.EnableTransactionManagement;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;

import javax.sql.DataSource;
import java.beans.PropertyVetoException;
import java.util.Properties;

@EnableWebMvc
@Configuration
@EnableTransactionManagement
@ComponentScan(basePackages = "org.example.rest")
public class MyConfig {

    @Bean
    public DataSource dataSource() {
        ComboPooledDataSource dataSource = new ComboPooledDataSource();
        try {
            dataSource.setDriverClass("com.mysql.cj.jdbc.Driver");
            dataSource.setJdbcUrl("jdbc:mysql://localhost:3306/my_db?useSSL=false&serverTimezone=UTC");
            dataSource.setUser("bestuser");
            dataSource.setPassword("bestuser");
        } catch (PropertyVetoException e) {
            throw new RuntimeException(e);
        }
        return dataSource;
    }

    @Bean
    public LocalSessionFactoryBean sessionFactoryBean() {
        LocalSessionFactoryBean sessionFactoryBean = new LocalSessionFactoryBean();
        sessionFactoryBean.setDataSource(dataSource());
        sessionFactoryBean.setPackagesToScan("org.example.rest.entity");

        Properties hibernateProperties = new Properties();
        hibernateProperties.setProperty("hibernate.dialect",
                "org.hibernate.dialect.MySQLDialect");
        hibernateProperties.setProperty("hibernate.show_sql",
                "true");

        sessionFactoryBean.setHibernateProperties(hibernateProperties);
        return sessionFactoryBean;
    }

    @Bean
    public HibernateTransactionManager hibernateTransactionManager() {
        HibernateTransactionManager manager = new HibernateTransactionManager();
        manager.setSessionFactory(sessionFactoryBean().getObject());
        return manager;
    }
}

初始化类

package org.example.rest.configuration;

import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;

public class MyWebInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {

    @Override
    protected Class<?>[] getRootConfigClasses() {
        return null;
    }

    @Override
    protected Class<?>[] getServletConfigClasses() {
        return new Class[]{MyConfig.class};
    }

    @Override
    protected String[] getServletMappings() {
        return new String[]{"/"};
    }
}

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>org.example</groupId>
    <artifactId>spring-rest</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.2.9.RELEASE</version>
        </dependency>

        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>4.0.1</version>
        </dependency>

        <dependency>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-core</artifactId>
            <version>5.4.24.Final</version>
        </dependency>

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.32</version>
        </dependency>

        <dependency>
            <groupId>com.mchange</groupId>
            <artifactId>c3p0</artifactId>
            <version>0.9.5.4</version>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-orm</artifactId>
            <version>5.3.9</version>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.22</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>2.11.3</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

可能的原因及解决办法

1. Spring版本不一致导致兼容性问题

pom.xml中spring-webmvc使用5.2.9.RELEASE，但spring-orm用的是5.3.9，版本不匹配会引发Spring组件加载异常，导致控制器无法被正确注册。

解决：统一Spring相关依赖版本，例如将spring-orm改为5.2.9.RELEASE：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-orm</artifactId>
    <version>5.2.9.RELEASE</version>
</dependency>

2. 不必要的Spring Boot插件干扰

当前项目是纯Spring MVC应用，但pom.xml中引入了spring-boot-maven-plugin，该插件会按Spring Boot规则打包，破坏传统Web应用的目录结构，导致Tomcat无法识别控制器。

解决：移除spring-boot-maven-plugin插件：

<!-- 移除该插件 -->
<!--
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
-->

3. Tomcat部署上下文路径错误

如果IDEA中Tomcat的部署上下文路径被设置为项目artifactId（/spring-rest），实际请求地址应为http://localhost:8080/spring-rest/api/hello，而非http://localhost:8080/api/hello。

解决：在IDEA的Tomcat配置中，进入Deployment选项，将应用的上下文路径修改为/。

4. 数据源初始化失败导致容器加载异常

MyConfig中配置的Hibernate数据源如果连接失败（如数据库未启动、用户名密码错误），会导致Spring容器初始化失败，控制器无法被加载。

解决：
- 检查MySQL服务是否正常运行，确认my_db数据库存在。
- 验证bestuser账号是否拥有my_db的访问权限。
- 可暂时注释Hibernate相关Bean配置，先让Hello World接口正常运行，再逐步添加数据库配置。

5. 组件扫描未生效

即使MyConfig设置了@ComponentScan(basePackages = "org.example.rest")，如果编译后的类未正确打包到Tomcat的WEB-INF/classes目录，控制器也不会被Spring扫描到。

解决：
- 执行mvn clean package命令，检查target目录下生成的war包中是否包含org/example/rest/controller/MyRestController.class文件。
- 在IDEA的Project Structure中，确认Modules的Sources目录标记正确，编译输出路径正常。

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

Spring MVC RestController 404排查：请求/api/hello资源不可用

我的代码 #

控制器类 #

配置类 #

初始化类 #

pom.xml #

可能的原因及解决办法 #

1. Spring版本不一致导致兼容性问题 #

2. 不必要的Spring Boot插件干扰 #

3. Tomcat部署上下文路径错误 #

4. 数据源初始化失败导致容器加载异常 #

5. 组件扫描未生效 #