若依框架新增模块404？三步搞定包扫描与自动注入问题

若依框架模块整合实战：彻底解决404与自动注入难题

1. 问题诊断与核心原理剖析

当在若依框架中新增业务模块时，开发者常会遇到两个典型问题：接口访问返回404错误和Spring Bean无法自动注入。这两个现象看似独立，实则都源于同一个核心机制——Spring Boot的组件扫描机制。

Spring Boot默认只会扫描启动类所在包及其子包下的组件。假设启动类RuoYiApplication位于com.ruoyi包下，而新增模块的包名为com.newmodule，那么该模块中的@Controller、@Service等注解类都不会被自动注册到Spring容器中。这直接导致：

1. 控制器无法映射请求路径，返回404
2. 服务类无法被注入，抛出NoSuchBeanDefinitionException

典型错误场景示例：

// 启动类包路径：com.ruoyi
@SpringBootApplication
public class RuoYiApplication {}

// 新模块控制器路径：com.newmodule.controller
@RestController
@RequestMapping("/new")  // 这个映射将失效
public class NewController {}

2. 三步解决方案详解

2.1 包路径一致性检查与规划

首先需要确认项目的包结构设计。推荐两种方案：

方案一：统一基础包路径

• 保持所有模块在com.ruoyi基础包下
• 例如：com.ruoyi.system、com.ruoyi.newmodule
• 优点：无需额外配置，符合Spring Boot默认扫描规则

方案二：多基础包路径

• 不同模块使用独立的基础包
• 例如：com.ruoyi、com.newmodule
• 需要显式配置组件扫描路径

包结构规划对照表：