Spring Boot 3.3.11升级后@Scheduled注解无法解析配置文件占位符导致WildFly部署失败

看起来你在从Spring Boot 2.x升级到3.x的过程中遇到了定时任务配置占位符解析的问题，这个报错提示无法识别sch.disable.autopopulateflag.cron配置项，我来帮你分析下可能的原因和解决办法。

可能的原因分析 #

Spring Boot 3.x基于Jakarta EE规范，在配置加载和Bean初始化的时序上做了不少调整，再结合WildFly的类加载机制，很可能出现@PropertySource加载的配置在@Scheduled注解解析时还未被上下文识别的情况。另外，Spring Boot 3.x默认已经会自动加载classpath:application.properties，手动添加@PropertySource反而可能干扰默认的配置加载流程，导致配置在定时任务解析时未就绪。

解决方案 #

方案1：移除冗余的@PropertySource注解 #

先试试去掉配置类上的@PropertySource("classpath:application.properties")，因为Spring Boot 3.x默认会自动扫描并加载classpath下的application.properties/application.yml文件，手动添加该注解可能打乱了默认的加载顺序。

修改后的配置类代码：

@Configuration
@EnableScheduling
public class SchedulerConfig {

    @Autowired
    @Lazy
    DisableAutoUpdateFlagBatchJob disableAutoUpdateFlagBatchJob;

    @Scheduled(cron = "${sch.disable.autopopulateflag.cron}")
    public void execDisableAutoUpdateFalg() {
        // 原有业务逻辑代码保持不变
    }
}

方案2：通过SchedulingConfigurer动态配置定时任务（更可靠） #

如果方案1无效，建议改用SchedulingConfigurer接口动态注册定时任务，这种方式能确保配置属性完全加载后再设置cron表达式，从根本上避免时序冲突问题。

示例代码：

@Configuration
@EnableScheduling
public class SchedulerConfig implements SchedulingConfigurer {

    @Autowired
    @Lazy
    DisableAutoUpdateFlagBatchJob disableAutoUpdateFlagBatchJob;

    @Value("${sch.disable.autopopulateflag.cron}")
    private String disableAutoPopulateCron;

    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        taskRegistrar.addCronTask(() -> {
            try {
                log.info(System.lineSeparator());
                log.info("SchedulerConfig :: execDisableAutoUpdateFalg() :: Starting");
                int recordsUpdated = disableAutoUpdateFlagBatchJob.disableAutoUpdateFlagForPreviousBiWeek();
                log.info("SchedulerConfig :: execDisableAutoUpdateFalg() :: Completed");
                log.info("SchedulerConfig :: execDisableAutoUpdateFalg() :: recordsUpdated = {}", recordsUpdated);
                log.info(System.lineSeparator());
            } catch (Exception ex) {
                log.error("Error occured during execution of execDisableAutoUpdateFalg() ");
                log.error(ex.getMessage(), ex);
            }
        }, disableAutoPopulateCron);
    }
}

方案3：检查WildFly部署的配置加载情况 #

如果上述方案都没解决问题，可能是WildFly的类加载机制导致配置文件未被正确读取：

• 解压war包确认application.properties确实在WEB-INF/classes目录下
• 尝试将配置文件放到WildFly的standalone/configuration目录，并在启动WildFly时添加系统参数指定配置位置：

  -Dspring.config.location=file:/path/to/wildfly/standalone/configuration/application.properties
  

另外，再仔细核对下配置键名的拼写（大小写敏感），确保代码中的${sch.disable.autopopulateflag.cron}和配置文件里的键完全一致。

内容来源于stack exchange