Togglz集成SpringBoot问题：特性始终处于禁用状态

我来帮你梳理下这个问题的常见排查点，结合你手动配置FeatureManager的场景，大概率是配置加载或者Bean定义的细节没到位：

• 检查手动FeatureManager的StateRepository配置
  手动创建FeatureManager时，必须明确指定从properties文件加载状态的逻辑，不然Togglz会默认用内存仓库，不会读取你的配置文件。比如你可以这样写：

  @Bean
  public FeatureManager featureManager() {
      return new FeatureManagerBuilder()
          .featureEnum(MyEnumFeatures.class)
          // 明确指定从properties文件加载状态
          .stateRepository(new PropertyBasedStateRepository(loadFeatureProperties()))
          .build();
  }
  
  private Properties loadFeatureProperties() {
      Properties props = new Properties();
      try {
          props.load(new ClassPathResource("features.properties").getInputStream());
      } catch (IOException e) {
          throw new RuntimeException("Failed to load features config", e);
      }
      return props;
  }
  

  这里要注意，PropertyBasedStateRepository会读取以features.为前缀的配置项，别写错前缀。

• 确认features.properties的语法和路径
  首先确保文件放在src/main/resources（主环境）或src/test/resources（测试环境）下，能被类路径加载到。然后语法必须严格匹配枚举常量名，比如你的枚举是MyEnumFeatures.CHECKOUT_V2，那配置项必须是：

  features.CHECKOUT_V2=true
  

  Togglz对枚举名称的大小写是严格敏感的，别出现大小写不一致的情况。

• 避免自动配置和手动配置的冲突
  既然自动配置没生效，建议直接禁用Togglz的自动配置，避免它的默认Bean和你手动定义的冲突。在启动类上加上：

  @SpringBootApplication
  @EnableAutoConfiguration(exclude = TogglzAutoConfiguration.class)
  public class YourApplication { ... }
  

  这样就能保证完全使用你手动定义的FeatureManager，不会有隐式的覆盖。

• 验证测试环境的配置加载
  如果是测试时出现问题，检查测试类是否正确加载了配置文件。可以在测试类上添加@TestPropertySource("classpath:features.properties")，或者在测试代码里打印特性状态，确认配置是否真的被读取：

  @Autowired
  private FeatureManager featureManager;
  
  @Test
  void testFeatureStatus() {
      for (MyEnumFeatures feature : MyEnumFeatures.values()) {
          System.out.printf("Feature %s is enabled: %b%n", feature.name(), featureManager.isActive(feature));
      }
  }
  

  通过打印日志就能直观看到是配置没加载，还是其他问题。

• 检查依赖版本兼容性
  最后确认下Togglz和Spring Boot的版本是否匹配：

  • Spring Boot 3.x 对应 Togglz 4.x 及以上版本
  • Spring Boot 2.x 对应 Togglz 3.x 版本
    如果版本不兼容，也可能出现配置不生效的奇怪问题。

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