Spring Boot跨Maven模块引入时schema初始化失效问题解决

核心原因 #

Spring Boot默认只会扫描当前启动模块的classpath根目录下的初始化SQL文件，base模块作为依赖模块，其资源文件需要被显式配置加载路径才能被识别。

具体解决方案 #

1. 确保base模块的schema.sql被正确打包 #

检查base模块的pom.xml，确保src/main/resources下的schema.sql会被打包进base的jar包：

• 若未自定义资源配置，Maven默认会自动包含src/main/resources下的所有文件，无需额外配置；
• 若有自定义<resources>节点，需明确包含SQL文件：

  <build>
      <resources>
          <resource>
              <directory>src/main/resources</directory>
              <includes>
                  <include>**/*.sql</include>
              </includes>
          </resource>
      </resources>
  </build>
  

2. 在外部application.properties中指定SQL文件路径 #

根据你的Spring Boot版本配置对应属性：

• Spring Boot 2.5+（推荐）：

  # 加载base模块classpath下的schema.sql，多模块SQL文件用逗号分隔
  spring.sql.init.schema-locations=classpath:/schema.sql
  # 可选：设置初始化模式，always为每次启动都执行，embedded仅嵌入式数据库执行
  spring.sql.init.mode=always
  

• Spring Boot 2.4及以下：

  spring.datasource.schema=classpath:/schema.sql
  spring.datasource.initialization-mode=always
  

3. 确认模块依赖关系 #

在web和backend模块的pom.xml中，添加对base模块的依赖，确保base的jar包被引入到启动模块的classpath：

<dependency>
    <groupId>你的项目groupId</groupId>
    <artifactId>base</artifactId>
    <version>项目版本号</version>
</dependency>

4. 验证生效情况 #

启动web或backend模块时，查看日志是否包含类似如下内容：

Executing SQL script from classpath resource [schema.sql]
如果日志中出现此信息，说明schema.sql已被正确加载执行。

常见排查点 #

• 检查schema.sql的文件名和路径是否正确，避免拼写错误；
• 若启动时提示文件不存在，可通过java -jar 启动模块.jar --debug查看classpath的详细内容，确认base模块的jar是否被加载；
• 确保spring.sql.init.mode（或旧版本initialization-mode）配置正确，若设置为never会直接跳过初始化。

内容的提问来源于stack exchange，提问作者comoon