idea搭建微服务多模块项目时遇到的问题汇总

比眉伴天荒 2024-04-01 19:06 56阅读 0赞

**目录**

1.Module "XXX" does exist

2.Module "A" must not contain source root "xxx". The root already belongs to module "B"

（1）分析

（2）解决方法

3.子模块的maven管理器呈灰色、yaml文件的小图标不正常、无法使用引入包中的功能（比如springboot依赖的@SpringBootApplication注解）

（1）异常状态下的截图

（2）分析

（3）解决方案

--------------------

## 1.Module "XXX" does exist ##

该问题常出现在执行【删除某个子模块后，又新建一个同名子模块】这种操作。

解决方法：进入**父工程的"Load/Unload Modules"选项**，然后将对应module unload即可。

![edcb3a40f02c4f7ab761fb70b7dbf192.png][]

![64ebe90bd8c34f07b1e4492a00e4cd8f.png][]

##  ##

## 2.Module "A" must not contain source root "xxx". The root already belongs to module "B" ##

报错信息如下图

![502523972b604a479b6ab583b934ec18.png][]

### （1）分析 ###

一个maven项目/模块下的目录通常分为：Sources、Tests、Resources、TestResources、Excluded这几种，如下图所示：

![16bbbb93bf744f5787653b562011a529.png][]

对于多模块项目而言，为了便于管理，通常会按照【父模块+子模块】这种方式构建项目。

父模块用于指定各种开发包的版本号，只起到约定的作用，自身在编译时不会引入开发包；

子模块继承父模块中的配置信息，自动进行版本仲裁，在编译时会正式引入依赖中规定的各类包。

知道这些以后，再看报错信息：“Module "A" must not contain source root "xxx". The root already belongs to module "B"，可知 **source root 这类目录发生了重复，那么一定是父模块的目录结构出了问题**，因为父模块只需保留pom.xml文件即可。

### （2）解决方法 ###

将父模块Modules设置中的Source Folders、Test Sources Folders等全部删除即可，下面两张图是正常的项目Modules配置：

![62943debbbc7438d9de5bc6b423b88d1.png][]

![3c1973ad84c9470289a354d710fbd138.png][]

## 3.子模块的maven管理器呈灰色、yaml文件的小图标不正常、无法使用引入包中的功能（比如springboot依赖的@SpringBootApplication注解） ##

### （1）异常状态下的截图 ###

具体表现形式如下：

①maven管理器呈现灰色

![324e7db36b8d47f292997549e6cc92b4.png][]

②yml文件前的图标异常

![96cfb50636f24af5a10356a3b5c3871f.png][]

### （2）分析 ###

如果模块自身的pom.xml没有写错的话，那么问题就不是项目的问题，而是maven管理器的问题。新建的maven项目都会有一个与之匹配的包管理器（有独立的生命周期），现在这个管理器呈现灰色说明**其本身肯定是在某个地方被关了或者屏蔽了**，从而造成无法使用当前模块依赖中的功能这一后果。

### （3）解决方案 ###

进入当前项目的setting中，找到Maven的Ignored Files配置，可以发现这里的屏蔽列表里把一个模块给勾选了，那么将其取消勾选即可，然后保存退出。

![f1030035a24e45899f97f89dd6b76974.png][]

接着在maven管理器中点击刷新

![e55f38635be24617a2d1e95eeacd7c6a.png][]

如此一番处理后，可以发现子模块恢复正常了，如下图：

![1d915ff6e35c435c86e3be47da24d49d.png][]

[edcb3a40f02c4f7ab761fb70b7dbf192.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/8553ccf39cf0483baec2451365cd9a26.png
[64ebe90bd8c34f07b1e4492a00e4cd8f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/6249239e340f43748ab5a99504c78aed.png
[502523972b604a479b6ab583b934ec18.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/719e1951c41c455fb5004ca9bfe43f26.png
[16bbbb93bf744f5787653b562011a529.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/42a52d6681d94680a5a554df1ee91ec4.png
[62943debbbc7438d9de5bc6b423b88d1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/06fb0ce43b1c47a5b59bbfb66488285d.png
[3c1973ad84c9470289a354d710fbd138.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/ea59a14f0aab4038b114c4c87450df17.png
[324e7db36b8d47f292997549e6cc92b4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/24e63766932b428ea98949e5348797fd.png
[96cfb50636f24af5a10356a3b5c3871f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/7ab166bb446d4ae797a8afbc1e446cdb.png
[f1030035a24e45899f97f89dd6b76974.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/9302140386bc4e82bb6a6cab139341e1.png
[e55f38635be24617a2d1e95eeacd7c6a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/46ba9afd932749b1af27e334c635c365.png
[1d915ff6e35c435c86e3be47da24d49d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/725b40d07a844b9198f948c8188a3813.png