Spring Boot主应用通过外部Jar按需加载MSSQL连接及依赖的实现

可行性结论 #

完全可行，启动时的java.lang.ClassNotFoundException: javax.persistence.criteria.Expression异常，本质是主应用仅配置了MongoDB，未引入外部Jar依赖的JPA相关基础包导致的。补全依赖并做好配置隔离即可解决问题。

具体实现步骤 #

1. 补全JPA与MSSQL依赖 #

外部Jar基于JPA和Spring Data JPA开发，但主应用未引入相关依赖，直接导致类加载失败。在主应用的构建文件中添加以下依赖：

Maven（pom.xml）

<!-- Spring Data JPA核心依赖，包含JPA API基础类 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<!-- MSSQL JDBC驱动，确保版本与外部Jar兼容 -->
<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
</dependency>

Gradle（build.gradle）

implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
implementation 'com.microsoft.sqlserver:mssql-jdbc'

2. 正确引入外部Jar #

由于无法通过Maven仓库引入，需手动添加至类路径：

• 将外部Jar放在主应用的src/main/resources/lib目录下
• 在构建文件中声明系统依赖：

Maven

<dependency>
    <groupId>com.external</groupId> <!-- 自定义分组ID -->
    <artifactId>mssql-data-client</artifactId> <!-- 自定义ArtifactID -->
    <version>1.0</version> <!-- 自定义版本 -->
    <scope>system</scope>
    <systemPath>${project.basedir}/src/main/resources/lib/your-external-jar-file.jar</systemPath>
</dependency>

Gradle

compile files('src/main/resources/lib/your-external-jar-file.jar')

3. 隔离MongoDB与JPA配置 #

避免Spring扫描混淆两类Repository，需明确指定各自的扫描范围：

• 主应用的启动类（或Mongo配置类）中，限定MongoRepository的扫描路径：

@SpringBootApplication
@EnableMongoRepositories(basePackages = "com.your.app.mongo.repositories")
public class MongoMainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MongoMainApplication.class, args);
    }
}

• 确保外部Jar的JPA Repository被扫描：若外部Jar未自带@EnableJpaRepositories配置，需在主应用中添加（指定外部Jar的Repository包路径）：

@Configuration
@EnableJpaRepositories(basePackages = "com.external.mssql.repositories")
public class ExternalJpaConfig {
}

4. 处理Bean冲突与数据源配置 #

• @Primary Service冲突：若外部Jar的Service标注了@Primary，且主应用存在同类型Bean，注入时需用@Qualifier指定外部Bean的名称（例如@Qualifier("externalMssqlService")），或在主应用中通过@Primary覆盖优先级。
• 数据源配置：外部Jar的MSSQL连接属性可通过主应用的application.properties/application.yml覆盖，确保连接参数正确：

# MSSQL数据源配置
spring.datasource.url=jdbc:sqlserver://your-mssql-host:1433;databaseName=target-db
spring.datasource.username=db-user
spring.datasource.password=db-pass
spring.datasource.driver-class-name=com.microsoft.sqlserver.jdbc.SQLServerDriver

# JPA配置（适配MSSQL）
spring.jpa.hibernate.ddl-auto=none
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.SQLServer2012Dialect

关键注意事项 #

• 确保外部Jar的依赖版本与主应用Spring Boot版本兼容，避免出现依赖冲突。
• 若外部Jar包含自动配置类，需确保Spring能扫描到（可通过@ComponentScan指定外部Jar的包路径）。

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