OptaPlanner中@InverseRelationShadowVariable报错：无效规划实体解决咨询

错误原因 #

你遇到的"not a valid planning entity"错误，核心原因是OptaPlanner要求@PlanningEntity必须包含至少一个@PlanningVariable——也就是OptaPlanner在求解过程中可以修改的变量。你把Room标记为@PlanningEntity，但没有给它定义任何可被规划的变量，因此触发了这个校验错误。

正确实现方案（无需将Room设为PlanningEntity） #

你的需求是让Room的lessons字段随Lesson的room字段同步更新，这完全不需要把Room设为规划实体。Room本质是问题事实（Problem Fact）——求解过程中固定不变的参考数据，而Lesson才是需要OptaPlanner调整的规划实体。

按以下步骤修改：

1. 还原Room的注解：移除Room类上的@PlanningEntity注解，保留它作为普通POJO或JPA实体（如果需要持久化）。
2. 确保Lesson的room字段是规划变量：在Lesson类中，room字段必须标记为@PlanningVariable，指定对应的范围提供者：

@PlanningVariable(valueRangeProviderRefs = {"roomRange"})
private Room room;

// 配套的getter和setter

3. 给Room添加InverseShadowVariable：在Room类的lessons字段上添加@InverseRelationShadowVariable，关联Lesson的room字段，这样OptaPlanner会自动维护这个集合的同步：

@InverseRelationShadowVariable(sourceVariableName = "room")
private List<Lesson> lessons = new ArrayList<>();

// 只提供getter即可（或添加setter但不要手动调用），这个集合由OptaPlanner自动更新

4. 检查Solver配置：确保你的Solver配置中，仅将Lesson列为规划实体，Room作为问题事实被纳入求解域（通常无需额外配置，只要在问题对象中包含Room集合即可）。

关键注意事项 #

• @InverseRelationShadowVariable标记的字段是只读的，绝对不要在业务代码中手动修改这个集合，所有更新由OptaPlanner自动处理。
• 问题事实类（如Room）不需要实现任何OptaPlanner特定接口或注解，它们是求解过程中的静态参考数据。

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