Spring Boot 学习系列（04）—分而治之，多module打包

此文已由作者易国强授权网易云社区发布。

欢迎访问网易云社区，了解更多网易技术产品运营经验。

明确功能，各司其职

在一个结构清晰的项目中，一个没有module划分的结构显然不是最佳实践。有人会说可以在同一个Project中定义不同的包名及包路径来做区分，但这样当功能复杂后并不可取。
当然，如果你的项目足够简单，比如只是提供一个很简单的微服务，没有分层治理的概念，那么则不需要关心这个问题了。
下面就Spring Boot环境中多module打包的注意事项列举如下，希望对大家有所帮助。

新建所需要的module模块，在此示例中新建两个module，bingo-core和bingo-web。其中bingo-core作为封装服务提供给bingo-web使用，bingo-web作为我们的工程的最终jar包提供服务。为了说明问题，我们仍然采用spring boot框架来构建这两个module。
具体新建步骤可参考《从0到1，只需两分钟》这篇文章，不同的是，在新建的时候选择新建module即可。新建完毕后，工程结构如下图所示。注意此时父pom文件的打包方式需要变更成pom,不再是jar或者war。

通过在bingo-core中新建一个类，然后在bingo-web中使用此类以说明问题。（示例类在此省略，大家可以自己试试）
这个时候如果我们不做任何修改，直接package就会出现问题，提示找不到bingo-core中的相关类。如下图所示：

那么问题就是这里了，这个问题和spring boot的打包方式有关系，spring boot默认将每个module打包成一个fat jar，这个jar包和我们正常使用的jar包内部的结构是不相同的，如下图所示，fat jar包含了直接运行所需要的所有信息（包含内嵌的容器，如果是一个web应用的话），那么类的加载路径此时就发生了变化，所以在编译时会提示找不到引用类。

这个时候我们只需要通过配置maven的插件参数来使相关需要使用的jar打包成正常的jar包即可。修改配置如下：

在需要变更打包方式的pom.xml文件中（如在bingo-core模块），修改插件配置如下所示：

<build>

  <plugins>

      <plugin>

          <groupId>org.springframework.boot</groupId>

          <artifactId>spring-boot-maven-plugin</artifactId>

          <configuration>

              <classifier>exec</classifier>

          </configuration>

          <executions>

              <execution>

                  <goals>

                      <goal>repackage</goal>

                  </goals>

              </execution>

          </executions>

      </plugin>

  </plugins></build>

另外需要注意的是，需要在bingo-core/bingo-web模块的测试类中加入@SpringBootTest注解的作用范围，如下图所示：

![image](https://github.com/siyuyifang/image/blob/master/spring-boot/4/4-3.png?raw=true)- 此时再执行maven的package命令即可发现打包成功。我们查看bingo-core打包生成的jar包可以发现，实际上会有两个，如下图所示，带-exec后缀的就是我们默认的fat jar。可以直接运行的jar包。

![image](https://github.com/siyuyifang/image/blob/master/spring-boot/4/4-4.png?raw=true)

多module的打包方式修改比较简单，但当出现这个问题时，如果不清楚其原因，还是比较折腾人的。

不足之处，欢迎指正，谢谢~

免费体验云安全(易盾)内容安全、验证码等服务

更多网易技术、产品、运营经验分享请点击。

相关文章：
【推荐】如何解决在线网页挂载本地样式的问题

巴特西

Spring Boot 学习系列（04）—分而治之，多module打包

明确功能，各司其职

最新文章

热门文章