Spring Boot集成Quartz构建报jdbcUrl is required with driverClassName错误如何解决

根因分析 #

1. Maven构建失败本质是单元测试阶段加载Spring上下文触发的错误，不是编译阶段问题。你配置了Quartz使用JDBC存储任务，SchedulerFactoryBean依赖DataSource，而测试运行时没有提供dburl、dbusername、dbpassword这些配置值，导致DataSource实例化时url为null，抛出jdbcUrl is required with driverClassName错误。
2. 无Quartz的分支可正常构建，是因为没有Scheduler依赖DataSource的逻辑，测试阶段不需要初始化DataSource，不会触发参数缺失报错。
3. 你在测试类虽然排除了数据源相关的自动配置，但自定义的DataSourceConfig和SchedulerConfig仍会被扫描加载，且你默认配置的活跃profile是dev，测试阶段默认加载dev的DataSource，参数为空就会报错。

可行解决方案 #

方案1：测试阶段排除Quartz和自定义数据源配置 #

适合当前测试仅验证Controller逻辑、不需要用到数据库和Quartz的场景：
修改测试类，增加排除扫描规则，不让测试上下文加载相关配置类：

@SpringBootTest
@ComponentScan(excludeFilters = {
    @ComponentScan.Filter(type = FilterType.ASSIGNABLE_TYPE, classes = {DataSourceConfig.class, SchedulerConfig.class})
})
@EnableAutoConfiguration(exclude = { 
    DataSourceAutoConfiguration.class,
    DataSourceTransactionManagerAutoConfiguration.class, 
    HibernateJpaAutoConfiguration.class,
    QuartzAutoConfiguration.class
})
@EnableConfigurationProperties(value = appConfig.class)
class PitApplicationTest {
  // 原有测试逻辑保持不变
}

你也可以给配置类增加条件加载注解，避免非运行环境加载：

// DataSourceConfig增加条件，只有dburl配置存在时才加载
@Configuration
@RequiredArgsConstructor
@ConditionalOnProperty(name = "dburl")
public class DataSourceConfig {
  // 原有逻辑保持不变
}

// SchedulerConfig增加条件，只有Quartz配置为jdbc存储时才加载
@Configuration
@ConditionalOnProperty(name = "spring.quartz.job-store-type", havingValue = "jdbc")
public class SchedulerConfig {
  // 原有逻辑保持不变
}

方案2：测试阶段使用内存数据库模拟数据源 #

适合测试需要用到数据库或Quartz逻辑的场景：
在test/resources目录下新建application-test.yaml，配置H2内存数据库：

spring:
  datasource:
    url: jdbc:h2:mem:testdb
    username: sa
    password:
    driver-class-name: org.h2.Driver
  quartz:
    jdbc:
      initialize-schema: embedded

然后在测试类上增加@ActiveProfiles("test")注解，测试阶段就会自动加载H2数据源，不会出现参数缺失问题。

方案3：临时跳过测试构建（不推荐，仅应急使用） #

如果需要快速打包，可以在Maven构建时加参数跳过单元测试：

mvn clean install -DskipTests

该方法仅能绕开问题，不能解决根本缺陷，不建议常规使用。

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