初始化规划变量引发Score Corruption，求原因及分数初始化方法

你遇到的Score Corruption直接原因是手动初始化变量后未同步更新分数状态。OptaPlanner的FULL_ASSERT模式会严格校验「当前解的变量状态」和「内部缓存的分数值」是否一致：

• 正常流程中，OptaPlanner通过Move操作修改变量时，会同步触发分数的增量计算（或全量计算），保证两者一致。
• 你直接给规划变量、影子变量赋值，跳过了这套同步机制，导致内部缓存的分数还是初始空值，和实际变量状态完全不匹配，触发了Score Corruption校验失败。

另外，手动给影子变量赋值是多余且危险的——影子变量是由规划变量推导而来的，手动赋值可能导致它和依赖的规划变量逻辑冲突，进一步加剧状态不一致问题。

按照以下流程操作，既能完成变量预初始化，又能避免Score Corruption：

步骤1：通过ScoreDirector管理变量变更 #

不要直接给实体的变量字段赋值，必须通过ScoreDirector的方法来追踪变量变更，确保OptaPlanner能感知到状态变化：

// 构建ScoreDirector
ScoreDirector<YourSolution> scoreDirector = solverFactory.getScoreDirectorFactory().buildScoreDirector();
YourSolution workingSolution = ...; // 你的初始解实例
scoreDirector.setWorkingSolution(workingSolution);

// 遍历实体，初始化规划变量（只处理规划变量，不要碰影子变量）
for (YourEntity entity : workingSolution.getEntityList()) {
    // 从值域提供器获取随机初始值
    YourVariable initialValue = yourValueRangeProvider.getRandomValue();
    
    // 告知ScoreDirector要修改变量
    scoreDirector.beforeVariableChanged(entity, "yourPlanningVariableName");
    // 赋值
    entity.setYourPlanningVariableName(initialValue);
    // 告知ScoreDirector变量修改完成
    scoreDirector.afterVariableChanged(entity, "yourPlanningVariableName");
}

步骤2：自动更新影子变量 #

完成规划变量初始化后，触发变量监听器，让OptaPlanner自动推导并更新所有影子变量：

scoreDirector.triggerVariableListeners();

步骤3：初始化分数 #

最后调用全量分数计算方法，让ScoreDirector根据当前变量状态计算正确的分数，并同步到内部缓存：

scoreDirector.calculateScore();

步骤4：启动求解器 #

现在这个预初始化的解状态是一致的，可以直接传入求解器运行：

Solver<YourSolution> solver = solverFactory.buildSolver();
YourSolution finalSolution = solver.solve(workingSolution);

• 永远不要手动修改影子变量，依赖OptaPlanner的变量监听器自动维护即可。
• 所有变量变更必须通过ScoreDirector的before/afterVariableChanged方法包裹，确保状态被正确追踪。
• FULL_ASSERT模式下，任何状态不一致都会被严格校验，这是排查问题的利器，但正式运行可以关闭以提升性能。

内容的提问来源于stack exchange，提问作者Tejdeep Reddy Hunabad