Maven聚合项目（微服务项目）创建流程，以及pom详解

一、创建流程

1、首先创建springboot项目作为父项目

只留下pom.xml 文件，删除src目录及其他无用文件

 2、创建子项目

子项目可以是maven项目，也可以是springboot项目

3、父子项目关联

 4、父项目中依赖管理

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
<!--    继承的springboot版本-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.3</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

<!--    引入子模块 -->
    <modules>
        <module>system</module>
        <module>gateway</module>
        <module>common</module>
    </modules>

    <groupId>com.matter</groupId>
    <artifactId>record</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>syh_matter_record_server</name>
    <description>syh_matter_record_server</description>
    <packaging>pom</packaging>

    <!-- 作用：公共依赖引入
         使用场景：基本所有子模块都用到的依赖-->
    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

        <!-- jdbc依赖包  -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
    </dependencies>

    <!-- 版本管理 -->
    <properties>
        <java.version>1.8</java.version>
        <spring.cloud.version>2021.0.1</spring.cloud.version>
        <spring.cloud.alibaba.version>2021.0.1.0</spring.cloud.alibaba.version>
        <mybatis.plus.version>3.4.3.4</mybatis.plus.version>
        <fastjson2.version>2.0.9</fastjson2.version>
        <pagehelper.version>1.4.3</pagehelper.version>
    </properties>

    <!-- 作用：依赖版本生命，不做依赖引入。使用dependencyManagement统一管理项目的版本号，确保应用的各个项目的依赖和版本一致，
               不用每个模块项目都弄一个版本号，不利于管理。 -->
    <dependencyManagement>
        <dependencies>
            <!-- spring-loud -->
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>${spring.cloud.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <!-- 阿里微服务 -->
            <dependency>
                <groupId>com.alibaba.cloud</groupId>
                <artifactId>spring-cloud-alibaba-dependencies</artifactId>
                <version>${spring.cloud.alibaba.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>

            <!-- mybatis-plus -->
            <dependency>
                <groupId>com.baomidou</groupId>
                <artifactId>mybatis-plus-boot-starter</artifactId>
                <version>${mybatis.plus.version}</version>
            </dependency>

            <!-- 阿里json解析 -->
            <dependency>
                <groupId>com.alibaba.fastjson2</groupId>
                <artifactId>fastjson2</artifactId>
                <version>${fastjson2.version}</version>
            </dependency>

            <!-- 分页插件-->
            <dependency>
                <groupId>com.github.pagehelper</groupId>
                <artifactId>pagehelper-spring-boot-starter</artifactId>
                <version>${pagehelper.version}</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

 depedencyManagement标签介绍

在maven的聚合工程中，父模块的pom文件中，使用dependencyManagement统一管理项目的版本号，确保应用的各个项目的依赖和版本一致，不用每个模块项目都弄一个版本号，不利于管理。

dependencyManagement里只是声明依赖，并不自动实现引入，需要子项目声明需要用的依赖。

1. 如果不在子项目中声明依赖，是不会从父项目中继承下来的；
2. 如果在子项目中写了该依赖项，但是没有指定具体版本，这时候才会从父项目中继承相应依赖，以及相应的version和scope;
3. 如果在子项目中写了该依赖项，并且项目中指定了版本号，那么会使用子项目中指定的版本，不再使用父项目指定的依赖版本号。

父项目使用depedencyManagement声明依赖，子工程引入依赖不需要声明版本

5、公共模块使用

第一步：创建公共模块 common

第二步：父子关联

第三步：其他模块使用公共模块 common

dependencies标签引入公共模块 common，然后就可以调用方法了

二、遇到的问题以及解决方法

1、公共模块被其他模块引入后使用，使用正常，打包报错 程序包 com.xxx.common.utils不存在或者xxx找不到符号

原因：SpringBoot工程打包编译时，会生成两种jar包，一种是普通的jar，另一种是可执行jar。默认情况下，这两种jar的名称相同，在不做配置的情况下，普通的jar先生成，可执行jar后生成，造成可执行jar会覆盖普通的jar。而service工程无法依赖common-utils工程的可执行jar，所以编译失败：程序包不存在。
解决：在common-utils工程中，pom.xml文件中加入配置即可：

<build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <classifier>exec</classifier>
                </configuration>
            </plugin>

        </plugins>
 </build>

2、Maven多模块项目无法加载其他模块（公共模块）下的Bean

比如公共模块中有redis序列化配置，以及redis工具类需要需要注入

 在需要使用的模块中的启动类添加 @ComponentScan注解

// 值为一个数组，表示扫描的路径，递归扫描到最后
@ComponentScan(basePackages = {"com.example"})

 这里看到我们两个模块刚好前缀一样，所以只配置一个路径即可