若依访问404 Initializing Spring DispatcherServlet 'dispatcherServlet' 问题解决

Tue, 21 Apr 2026 15:00:00 +0800

问题描述

新建若依模块之后，启动项目访问接口出现 404，控制台只输出一句： Initializing Spring DispatcherServlet ‘dispatcherServlet’ 没有其他报错信息，接口无法访问。

问题原因

出现这种情况通常有以下几种可能：

模块没有被正确扫描，Controller 没有注入 Spring 容器
包路径不规范，不在默认扫描范围 com.ruoyi 下
启动类没有扫描到新包
访问路径写错
被权限框架拦截
路由配置错误

解决方案

一、检查包名结构

若依默认扫描的包是： com.ruoyi 你的新模块必须在 com.ruoyi.xxx 下，否则不会被加载。错误结构示例： com.test.project 正确结构：

1
2
3

com.ruoyi.project
com.ruoyi.demo
com.ruoyi.xxx

二、检查启动类扫描范围

在启动类 RuoYiApplication.java 中确认扫描包：

@SpringBootApplication(scanBasePackages = "com.ruoyi")
public class RuoYiApplication {
    public static void main(String[] args) {
        SpringApplication.run(RuoYiApplication.class, args);
    }
}

如果你的模块不在 com.ruoyi 下，需要手动加入：

`1`	`scanBasePackages = {"com.ruoyi", "com.自定义包"}`

三、检查 Controller 注解

确保类上添加了 @RestController 或 @Controller：

@RestController
@RequestMapping("/demo")
public class DemoController {

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

四、检查访问路径是否正确

如果 Controller 是：

@RequestMapping("/user")
public class UserController {

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

访问路径应为： http://localhost:8080/user/info

五、检查是否被权限拦截

在 SecurityConfig.java 中放行路径：

`1`	`.antMatchers("/demo/**").permitAll()`

六、检查是否注册到 Spring 容器

启动时打开日志，查看是否有你的 Controller 被加载：

`1`	`com.ruoyi.xxx.controller.XXXController`

如果没有出现，说明没有被扫描到。

七、检查 Spring MVC 配置

确认 DispatcherServlet 正常加载，控制台应出现类似日志：

1
2

Mapping servlet: 'dispatcherServlet' to [/]
Mapped URL path [/demo/**] onto handler XXXController

七、最终总结

出现 Initializing Spring DispatcherServlet ‘dispatcherServlet’ 且接口 404，99% 是以下原因：

包不在com.ruoyi下
Controller没加注解
路径写错
被权限拦截
模块未被Spring 扫描
按照上面步骤逐一排查即可解决。

RuoYi on 进制动态