使用OptaPy排课时报java.lang.IllegalStateException包装对象错误求助

常见原因及修复步骤 #

1. 规划实体继承与变量配置冲突 #

• 若基类Slot标记了@planning_entity，需确保子类Lesson和Lab的timeslot规划变量配置不冲突：基类不要指定value_range_provider_refs，让子类各自定义专属的时间槽范围。
  示例代码：

  from optapy import problem_fact, planning_entity, planning_variable
  
  @problem_fact
  class Base:
      def __init__(self, id):
          self.id = id
  
  # 基类不指定规划变量的范围
  @planning_entity
  class Slot(Base):
      def __init__(self, id):
          super().__init__(id)
          self.timeslot = None
  
      @planning_variable(Timeslot, value_range_provider_refs=None)
      def get_timeslot(self):
          return self.timeslot
  
      def set_timeslot(self, timeslot):
          self.timeslot = timeslot
  
  # 子类单独配置时间槽范围
  @planning_entity
  class Lab(Slot):
      def __init__(self, id, room, teacher, subject, student_group):
          super().__init__(id)
          self.room = room
          self.teacher = teacher
          self.subject = subject
          self.student_group = student_group
  
      @planning_variable(Timeslot, value_range_provider_refs=['lab_timeslot_range'])
      def get_timeslot(self):
          return self.timeslot
  
      def set_timeslot(self, timeslot):
          self.timeslot = timeslot
  

2. Problem Fact/规划实体序列化问题 #

• 所有被@problem_fact和@planning_entity装饰的类必须实现__eq__和__hash__方法，OptaPlanner依赖这些方法识别对象：

  @problem_fact
  class Timeslot(Base):
      def __init__(self, id, day_of_week, start_time, end_time):
          super().__init__(id)
          self.day_of_week = day_of_week
          self.start_time = start_time
          self.end_time = end_time
  
      def __eq__(self, other):
          if not isinstance(other, Timeslot):
              return False
          return self.id == other.id
  
      def __hash__(self):
          return hash(self.id)
  

• 检查Lab类的属性类型，避免使用无法被OptaPy转换为Java对象的自定义类型，时间尽量用Python标准datetime或字符串。

3. 时间槽范围配置错误 #

• 确保为Lab配置的value_range_provider存在且返回合法的Timeslot集合，示例：

  from optapy import planning_solution, value_range_provider, planning_entity_collection_property
  
  @planning_solution
  class Timetable:
      def __init__(self, timeslot_list, room_list, lesson_list, lab_list):
          self.timeslot_list = timeslot_list
          self.room_list = room_list
          self.lesson_list = lesson_list
          self.lab_list = lab_list
  
      @value_range_provider(id='lab_timeslot_range')
      def get_lab_timeslot_range(self):
          # 返回Lab专属的时间槽集合，比如时长≥2小时的槽位
          return [slot for slot in self.timeslot_list if slot.end_time - slot.start_time >= timedelta(hours=2)]
  
      @planning_entity_collection_property(Lab)
      def get_lab_list(self):
          return self.lab_list
  

4. 规划实体重复注册问题 #

• 如果Slot只是抽象基类，不要标记@planning_entity，仅在Lesson和Lab子类上标记该注解，避免重复注册导致的对象包装冲突。

额外检查点 #

• 验证Lab初始化时传入的Timeslot是否属于其配置的合法范围，初始值超出范围会触发包装错误。
• 确保Room、Teacher等关联类都被正确标记为@problem_fact，未标记的类会导致OptaPy无法识别。

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