Timefold/OptaPlanner启动失败：Collector注册重复指标名报错

问题根源 #

timefold_solver_solve_duration_seconds指标重复注册的核心原因是同一指标被多次绑定到Micrometer的MeterRegistry，常见场景包括：

• 重复创建Solver实例（如每次调用solve()都新建Solver）
• Spring自动配置与自定义配置重复绑定MicrometerCollector
• 依赖重复引入导致的版本冲突或重复注册逻辑

具体解决办法 #

1. 确保Solver/SolverManager为单例实例 #

在SpringBoot中，必须保证Solver或SolverManager是全局单例，避免重复创建导致多次注册指标：

// 配置SolverFactory为单例Bean
@Bean
public SolverFactory<YourPlanningEntity> solverFactory() {
    return SolverFactory.createFromXmlResource("your-solver-config.xml");
}

// 基于SolverFactory构建单例Solver
@Bean
public Solver<YourPlanningEntity> solver(SolverFactory<YourPlanningEntity> solverFactory) {
    return solverFactory.buildSolver();
}

// 或者使用SolverManager（推荐用于异步求解）
@Bean
public SolverManager<YourPlanningEntity, Long> solverManager(SolverFactory<YourPlanningEntity> solverFactory) {
    return SolverManager.create(solverFactory);
}

2. 禁用自动Micrometer绑定，手动控制注册 #

通过配置关闭框架自动绑定Micrometer，然后手动注册一次Collector，避免重复：

步骤1：添加配置

在application.properties中添加：

# Timefold配置
timefold.solver.micrometer.enabled=false
# OptaPlanner配置（切换框架时用）
optaplanner.solver.micrometer.enabled=false

步骤2：手动注册Collector

@Autowired
private MeterRegistry meterRegistry;

@Bean
public Solver<YourPlanningEntity> solver(SolverFactory<YourPlanningEntity> solverFactory) {
    Solver<YourPlanningEntity> solver = solverFactory.buildSolver();
    // 仅手动注册一次MicrometerCollector
    new MicrometerCollector(solver).bindTo(meterRegistry);
    return solver;
}

3. 排查并清理重复依赖 #

使用依赖分析工具检查是否存在重复的micrometer或规划器依赖：

• Maven：执行mvn dependency:tree，查找重复的micrometer-core或timefold-solver-spring-boot-starter/optaplanner-spring-boot-starter依赖，通过<exclusions>排除重复项。
• Gradle：执行./gradlew dependencies，同理清理重复依赖。

4. 修正MeterFilter配置（确保生效时机） #

之前的MeterFilter无效可能是因为注册时机晚于指标注册，需确保Filter优先加载：

@Bean
public MeterFilter duplicateMetricFilter() {
    // 直接拒绝重复指标，或重命名避免冲突
    return MeterFilter.denyNameStartsWith("timefold_solver_solve_duration_seconds")
            .andThen(MeterFilter.acceptAll());
}

或者重命名指标：

@Bean
public MeterFilter renameDuplicateMetricFilter() {
    return MeterFilter.rename(name -> {
        if (name.equals("timefold_solver_solve_duration_seconds")) {
            return name + "_single_instance";
        }
        return name;
    });
}

额外排查点 #

• 检查代码中是否存在多处创建Solver实例的逻辑（如在Controller方法内新建Solver）
• 确认Spring自动配置类（如TimefoldAutoConfiguration）是否未被正确禁用，导致重复绑定Collector

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