Camunda LazyInitRegistration类中ApplicationContext未设置问题求助

可能的原因及对应解决方案 #

1. 检查Spring组件扫描范围 #

• 确认Spring Boot主启动类的组件扫描范围是否覆盖了org.camunda.bpm.spring.boot.starter.webapp.filter包（LazyInitRegistration所在包）。若自定义了扫描路径或主类不在根包下，可能导致该类未被Spring容器识别。
• 解决：在主启动类上补充扫描配置，例如：

  @SpringBootApplication
  @ComponentScan(basePackages = {"你的业务根包", "org.camunda.bpm.spring.boot.starter.webapp.filter"})
  public class YourApplication {
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

2. 排查全局延迟加载配置 #

• 若开启了Spring Boot全局延迟加载（spring.main.lazy-initialization=true），LazyInitRegistration的初始化会被推迟，而LazyDelegateFilter可能在它之前被调用，引发NPE。
• 解决：
  • 关闭全局延迟加载：将spring.main.lazy-initialization设为false；
  • 或单独为LazyInitRegistration配置非延迟加载：

    @Configuration
    public class CamundaBeanConfig {
        @Bean
        @Lazy(false)
        public LazyInitRegistration lazyInitRegistration() {
            return new LazyInitRegistration();
        }
    }
    

3. 确认Camunda依赖完整性 #

• 避免仅引入camunda-bpm-spring-boot-starter-webapp-core子包，完整的webapp starter会自动处理组件注册逻辑。确保pom.xml中引入正确依赖：

  <dependency>
      <groupId>org.camunda.bpm.springboot</groupId>
      <artifactId>camunda-bpm-spring-boot-starter-webapp</artifactId>
      <version>7.17.0</version>
  </dependency>
  

4. 排查Bean初始化顺序干扰 #

• 自定义的Filter或BeanPostProcessor可能干扰LazyInitRegistration的初始化顺序，导致setApplicationContext未被及时调用。
• 解决：
  • 检查自定义BeanPostProcessor是否过滤了Camunda相关Bean；
  • 为LazyInitRegistration设置高优先级：

    @Component
    @Order(Ordered.HIGHEST_PRECEDENCE)
    public class LazyInitRegistration implements ApplicationContextAware, ServletContextInitializer {
        // 原有代码
    }
    

5. 版本兼容性临时调整 #

• Spring Boot 2.6.x在Bean初始化逻辑上的改动可能与Camunda 7.17.0存在兼容性问题，可尝试降级到Spring Boot 2.5.x版本（如2.5.14）验证问题是否消失。

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