maven聚合工程整合springboot+mybatisplus遇到的问题

前言（可以直接跳过看下面解决方法）

项目结构

两个module：

yema-terminal-boot 是springboot项目，子包有：controller、service、dao 等等。属于经典三层架构。那么，该module可以理解为是一个单体项目，采用MVC软件设计模式+三层体系的编程思想构建而成

yema-common 的作用，就是存放一些公用的资源，任何公用的都放这里，除了常用自定义工具类，还包括接口！然后该module的pom.xml文件中定义了整个项目所需要的依赖jar包。这样做，yema-terminal-boot 的pom.xml中只需要依赖 yema-common 即可。

为什么这样设计两个module？

也许，市面上的Maven聚合工程，挺多人是这样弄的，比如：

yema-terminal-boot

yema-service

yema-dao

yema-common

这样也可以，就是有个问题。当我再次新建一个module作为另一个单体项目时，那么这个单体项目的业务层和持久层，都得写yema-service、yema-dao 中。当业务多了，项目经手的程序员多了，可能会出现乱调用现象。就是说yema-service 中的某个接口，其实是只服务于其中一个单体项目，另一个单体项目是不能用的。但是却调用了，虽然功能也实现了，但给以后埋下了个地雷。

而我目前这种只用两个module，就是为了强制规范。是这个项目的就这个项目里写，不要偷懒去复用。虽然工作量多了点，但以后排查与修改问题就好很多。（我就接手了这种项目，生产支付调用问题，发现多个springboot启动类调用到，头皮发麻，改一下，要测试多个项目）

整合

父pom.xml

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.yema</groupId>
    <artifactId>YMRoot</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>

    <modules>
        <module>yema-common</module>
        <module>yema-terminal-boot</module>
    </modules>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>

    <!-- 继承说明：这里继承SpringBoot提供的父工程 -->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.3.4.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.yema</groupId>
                <artifactId>yema-common</artifactId>
                <version>1.0-SNAPSHOT</version>
            </dependency>
        </dependencies>
    </dependencyManagement>

</project>

yema-terminal-boot的pom.xml

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>YMRoot</artifactId>
        <groupId>com.yema</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>yema-terminal-boot</artifactId>

    <dependencies>
        <dependency>
            <groupId>com.yema</groupId>
            <artifactId>yema-common</artifactId>
        </dependency>
    </dependencies>

    <build>
        <finalName>ym-terminal-boot</finalName>
        <plugins>
            <plugin>
                <!--该插件主要用途：可执行的 JAR / WAR  -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

yema-common的pom.xml

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>YMRoot</artifactId>
        <groupId>com.yema</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

    <artifactId>yema-common</artifactId>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions><!-- 去掉springboot默认配置 -->
                <exclusion>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-starter-logging</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <!--引入log4j2启动日志打印-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-log4j2</artifactId>
        </dependency>
        <!--连接sqlserver-->
        <dependency>
            <groupId>com.microsoft.sqlserver</groupId>
            <artifactId>mssql-jdbc</artifactId>
            <scope>runtime</scope>
        </dependency>
        <!-- 以简单的注解形式来简化java代码，提高开发人员的开发效率。Lombok能通过注解的方式，在编译时自动为属性生成构造器、getter/setter、equals、hashcode、toString方法-->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
        <!--  json处理 -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.73</version>
        </dependency>
        <!--  Apache工具包   -->
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
        </dependency>
        <!-- 配置阿里数据库连接池，要配置log4j12这个包，不然报错 start        -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid</artifactId>
            <version>1.2.8</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
        </dependency>
        <!-- 配置阿里数据库连接池，要配置log4j12这个包，不然报错 end        -->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.25</version>
        </dependency>
        <!--   mybatisplus 持久层框架 start     -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.3.2</version>
        </dependency>
        <!-- 配置分页乐观锁插件时需要 -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-extension</artifactId>
            <version>3.4.2</version>
        </dependency>
        <!--   mybatisplus 持久层框架 end     -->

        <!-- JSON Web Token（JWT）库 start-->
        <dependency>
            <groupId>io.jsonwebtoken</groupId>
            <artifactId>jjwt-api</artifactId>
            <version>0.11.5</version>
        </dependency>
        <dependency>
            <groupId>io.jsonwebtoken</groupId>
            <artifactId>jjwt-impl</artifactId>
            <version>0.11.5</version>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>io.jsonwebtoken</groupId>
            <artifactId>jjwt-jackson</artifactId>
            <version>0.11.5</version>
            <scope>runtime</scope>
        </dependency>
        <!-- JSON Web Token（JWT）库 end-->

        <!-- 第三方get post请求  start     -->
        <dependency>
            <groupId>org.apache.httpcomponents</groupId>
            <artifactId>httpclient</artifactId>
            <version>4.5.13</version> <!-- 根据需要使用最新版本 -->
        </dependency>
        <dependency>
            <groupId>org.apache.httpcomponents.client5</groupId>
            <artifactId>httpclient5</artifactId>
            <version>5.2.3</version>
        </dependency>
        <!-- 第三方get post请求  end     -->
        <!-- 文件传输 -->
        <dependency>
            <groupId>com.sun.jersey</groupId>
            <artifactId>jersey-client</artifactId>
            <version>1.19.4</version>
        </dependency>

        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>2.11.0</version>
        </dependency>

        <dependency>
            <groupId>net.coobird</groupId>
            <artifactId>thumbnailator</artifactId>
            <version>0.4.8</version>
        </dependency>

        <!--百度人脸识别-->
        <dependency>
            <groupId>com.baidu.aip</groupId>
            <artifactId>java-sdk</artifactId>
            <version>4.12.0</version>
        </dependency>

    </dependencies>
</project>

整合遇到的问题

1、Invalid bound statement (not found)

（前提是首先你得排查下注解以及扫描以及mapper.xml中的namespace引用是否正确）

这是没有扫描到对应的mapper.xml。原因是mybatis-plus 3.1.2 版本后，里面已经设置默认扫描位置为：classpath*:mapper/**/*.xml，见配置文件：MybatisPlusProperties

所以在springboot的yml中要配置成

mybatis-plus:
  mapper-locations: classpath*:mapper/*.xml
  type-aliases-package: com.yema
  configuration:
    log-impl: org.apache.ibatis.logging.log4j2.Log4j2Impl #开启sql日志
    #    log-impl: org.apache.ibatis.logging.nologging.NoLoggingImpl #关闭sql日志
    default-enum-type-handler: com.baomidou.mybatisplus.extension.handlers.MybatisEnumTypeHandler
    call-setters-on-nulls: true #设置值为null时字段也返回给前端
    cache-enabled: true #开启缓存
    lazy-loading-enabled: true #开启懒加载
    aggressive-lazy-loading: false #关闭立即加载
    jdbc-type-for-null: null #因为mybatis对所有的null都映射的是原生Jdbc的OTHER类型，oracle不能正确处理，所以修改jdbcTypeForNull的值为null
    map-underscore-to-camel-case: true #开启驼峰转换，就是数据库的字段是student_id 对应 实体类属性 studentId

2、Maven打包后没有没有BOOT-INF等目录

原因是在springboot对应的module（yema-terminal-boot）的pom.xml中缺少

<build>
        <finalName>ym-terminal-boot</finalName>
        <plugins>
            <plugin>
                <!--该插件主要用途：可执行的 JAR / WAR  -->
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>