Jeecg-Boot多模块开发中404问题的排查与解决

问题背景

在使用Jeecg-Boot 3.7.1版本进行多模块开发时，开发者遇到了新建模块请求返回404的问题。该问题出现在未使用jeecg默认包名的情况下，尽管已经正确配置了包扫描路径和相关依赖。

问题现象

开发者描述的主要现象包括：

1. 新建模块的API请求返回404错误
2. 过滤器可以拦截到请求，但控制器未被正确映射
3. 使用jeecg默认包名时功能正常，自定义包名时出现问题

配置检查要点

根据问题描述，正确的多模块开发配置应包含以下关键点：

1. POM依赖配置：

   • 主项目和启动模块都需要引入新建的模块依赖
   • 必须包含jeecg-boot-base-core依赖

2. YAML配置：

   • application-dev.yml中需要配置Mybatis Plus的mapper路径
   • 需要配置MybatisPlusSaasConfig的mapper路径

3. Swagger配置：

   • Swagger2Config中需要添加新建模块的包路径

4. 包扫描配置：

   • 需要确保Spring能够扫描到新建模块中的组件

常见解决方案

1. 包扫描路径确认：

   • 检查主启动类上的@ComponentScan注解
   • 确保扫描路径包含新建模块的包路径
   • 如果使用自定义包名，需要显式添加扫描路径

2. Maven依赖验证：

   • 执行完整的Maven clean和install操作
   • 检查模块间的依赖关系是否正确
   • 确认所有模块都已正确安装到本地仓库

3. 配置项复查：

   • 检查application.yml中的mybatis-plus配置
   • 确认mapper-locations路径包含新建模块的mapper文件
   • 检查实体类扫描路径是否正确

4. 缓存清理：

   • 清理IDE的构建缓存
   • 重启应用服务器
   • 必要时清理浏览器缓存

深入分析

当使用非默认包名时出现404问题，通常表明Spring未能正确扫描和注册控制器组件。这可能是由于：

1. 主应用的组件扫描范围未覆盖新建模块
2. 自动配置类未被正确加载
3. 包路径配置存在拼写错误或路径不匹配
4. 模块间的依赖关系未正确建立

最佳实践建议

1. 包名规划：

   • 建议在自定义包名中保留jeecg相关前缀
   • 保持包结构的清晰和一致性

2. 配置管理：

   • 使用属性文件统一管理包扫描路径
   • 为不同环境维护独立的配置文件

3. 开发流程：

   • 在添加新模块后执行完整的构建流程
   • 使用IDE的依赖分析工具检查模块关系
   • 定期清理构建产物和缓存

通过系统性地检查上述各个环节，通常可以解决Jeecg-Boot多模块开发中的404问题。关键在于确保组件能够被正确扫描和注册，以及所有配置项的一致性和准确性。