Ruoyi-Vue-Pro项目Controller接口404问题排查指南

在使用Ruoyi-Vue-Pro项目时，开发者可能会遇到一个常见问题：项目能够正常启动，但Controller中的接口却无法访问，返回404错误。本文将详细分析这一问题的原因及解决方案。

问题现象

当开发者按照文档说明操作，完成模块建立、代码生成和代码复制后，项目启动过程没有报错，前端页面也能正常显示，但通过Postman或其他工具调用后端接口时却返回404状态码。

根本原因分析

经过深入排查，这类问题通常由以下几个原因导致：

1. 模块扫描配置缺失：主启动类(YudaoServerApplication)中未正确添加新模块的包扫描路径
2. Maven依赖问题：新模块未被正确添加到父模块的依赖管理中
3. 包路径不规范：Controller类未放置在正确的包路径下

详细解决方案

1. 检查主启动类配置

确保主启动类(YudaoServerApplication)上添加了正确的包扫描注解：

@SpringBootApplication
@MapperScan({"cn.iocoder.yudao.module.*.dal.mysql"})
@ComponentScan("cn.iocoder.yudao")
public class YudaoServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(YudaoServerApplication.class, args);
    }
}

特别要注意@ComponentScan注解是否包含了新模块的包路径。

2. 验证Maven依赖

在父模块(yudao-server)的pom.xml中，确保已添加新模块的依赖：

<modules>
    <module>yudao-module-system</module>
    <!-- 添加你的新模块 -->
    <module>yudao-module-your-module</module>
</modules>

3. 确认包结构规范

Controller类必须放置在正确的包路径下，通常应为： cn.iocoder.yudao.module.[模块名].controller.[子模块名].vo

4. 完整排查步骤

1. 执行Maven的clean和install操作
2. 在IDE中刷新Maven项目
3. 检查项目启动日志，确认新模块的Controller是否被加载
4. 使用Swagger UI或直接访问"/v3/api-docs"验证接口文档是否包含新接口

最佳实践建议

1. 代码生成后检查：使用代码生成器生成代码后，务必检查生成的类是否放置在正确包路径下
2. 分层明确：保持Controller、Service、Mapper等各层代码结构清晰
3. 日志监控：启动时关注Spring的组件扫描日志，确认所有预期组件都被加载
4. 接口测试：开发过程中使用Postman或Swagger及时验证接口可用性

通过以上步骤，开发者可以系统性地排查和解决Ruoyi-Vue-Pro项目中Controller接口404的问题，确保项目各模块能够正常协同工作。