OptaPlanner手动初始化解决方案后影子变量全为null的排查求助

• 先确认规划变量已正确赋值
  影子变量完全依赖规划变量的取值，如果你在调用triggerVariableListeners()前，没有给实体的**规划变量（带@PlanningVariable注解的字段）**设置有效取值，影子变量自然不会被计算。必须先遍历所有规划实体，给每个实体的规划变量赋值完成后，再触发监听。

• 必须在ScoreDirector的working solution上下文中修改
  不能直接修改脱离ScoreDirector管理的解决方案实例，必须通过scoreDirector.getWorkingSolution()获取当前的工作解决方案，所有实体修改都要基于这个实例操作。如果修改的是外部创建的Solution对象，ScoreDirector无法感知变化，影子变量也不会更新。

• 检查影子变量的注解配置
  核对@ShadowVariable注解的参数是否正确：

  • sourceVariableName必须和对应的规划变量字段名完全一致；
  • variableListenerClass必须是正确实现VariableListener的类，且类中的afterVariableChanged、afterEntityAdded等方法逻辑正确，确保能根据源变量的变化计算并设置影子变量的值。
    如果Listener逻辑写错（比如没有正确找到对应的影子变量字段，或者赋值逻辑错误），就算触发监听也不会生效。

• 遵循ScoreDirector的修改流程
  修改实体前必须通知ScoreDirector，完整的修改流程应该是：

  // 获取工作解决方案
  MySolution workingSol = scoreDirector.getWorkingSolution();
  for (Task task : workingSol.getTaskList()) {
      // 通知ScoreDirector即将修改该实体
      scoreDirector.beforeEntityChanged(task);
      // 设置规划变量的值
      task.setAssignedMachine(selectMachineForTask(task));
      // 通知ScoreDirector修改完成
      scoreDirector.afterEntityChanged(task);
  }
  // 触发影子变量更新
  scoreDirector.triggerVariableListeners();
  

  跳过beforeEntityChanged/afterEntityChanged会导致ScoreDirector无法追踪实体变化，进而影响影子变量的计算。

• 检查影子变量的setter方法
  VariableListener需要通过setter方法来更新影子变量，确保影子变量字段有对应的public setter，且方法名符合JavaBean规范（比如字段是machineLoad，setter是setMachineLoad(...)）。如果setter不存在或访问权限不足，Listener无法赋值，影子变量会保持null。

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