OptaPlanner自定义规则实现问题：最大化员工连续排班

场景说明 #

现有10个1小时时长的班次，两名兼职员工（每日最多工作4小时），目标是最大化同一员工的连续班次分配，预期结果为每人承接4个连续班次，剩余2个班次空置。

现有规则的核心逻辑问题 #

• join与ifNotExists条件冲突：
  你在join时限定s1.end < s2.start，但ifNotExists的条件组合后实际是在找s1.end == s2.start的班次，逻辑矛盾导致规则无法正确识别连续班次。
• 惩罚逻辑反向：
  OptaPlanner以最小化总惩罚值为目标，你当前的(24*60)-breakLength会给连续班次（breakLength=0）一个极大的惩罚值，完全违背“最大化连续班次”的目标。
• 重复匹配未规避：
  join两个Shift会生成(s1,s2)和(s2,s1)的重复对，仅通过!Objects.equals(s1,s2)无法避免重复计算，影响分数准确性。

优化的规则实现思路 #

要实现目标，核心是奖励同一员工、同一天内连续衔接的班次对，以下是修正后的规则示例：

连续班次奖励规则 #

Constraint maximizeConsecutiveShifts(ConstraintFactory constraintFactory) {
    return constraintFactory.forEach(Shift.class)
            // 匹配同一员工、同一天，且s1的结束时间等于s2的开始时间（连续衔接）
            .join(Shift.class,
                    equal(Shift::getEmployee),
                    equal(Shift::getDay),
                    equal(s1 -> s1.getEndDateTime(), Shift::getStartDateTime),
                    // 用唯一ID限定顺序，避免重复匹配
                    lessThan(Shift::getId, Shift::getId))
            // 每一对连续班次给予正向奖励
            .rewardConfigurableLong("maximize_consecutive_shifts", (s1, s2) -> 1L);
}

每日工时上限约束（必须补充） #

别忘了添加员工每日最多4小时的约束，避免违反合同限制：

Constraint maxDailyWorkingHours(ConstraintFactory constraintFactory) {
    return constraintFactory.forEach(Employee.class)
            .join(Shift.class, equal(Employee::getId, Shift::getEmployeeId))
            .groupBy((employee, shift) -> employee, sum(shift -> shift.getDurationInMinutes()))
            .filter((employee, totalMinutes) -> totalMinutes > 4 * 60)
            // 超出时长部分按分钟惩罚
            .penalizeConfigurableLong("max_daily_hours", (employee, totalMinutes) -> totalMinutes - 4 * 60);
}

排查验证步骤 #

• 开启分数调试：
  在OptaPlanner配置中启用调试模式，查看每个约束的分数贡献，确认规则是否正确触发：

  <scoreDirectorFactory>
      <constraintProviderClass>your.package.YourConstraintProvider</constraintProviderClass>
      <debugScoreDirectorFactory>true</debugScoreDirectorFactory>
  </scoreDirectorFactory>
  

  或通过Java API设置debugMode(true)，追踪每一步分数变化的具体原因。
• 验证时间字段准确性：
  确认getEndDateTime()、getStartDateTime()、getDay()的返回值无错误，比如时区问题、日期分组错误等。
• 分步测试规则：
  先实现简单的统计规则（比如统计员工班次数量），确认员工与班次的关联逻辑正确，再逐步添加连续班次的判断条件，避免逻辑叠加导致混乱。

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