使用Room Relations时出现非空参数为Null异常求助

异常原因 #

这个空指针异常的核心是Room关联查询返回了null，但Kotlin非空字段强制要求必须有值，具体触发场景包括：

• 数据库中当前MeetingEntity对应的MenuEntity记录不存在，Room执行@Relation关联查询时返回null，但PopulatedMeeting里的menu字段被定义为非空类型（未加?），Kotlin空检查机制直接抛出异常。
• 外键配置错误：MeetingEntity的menuId字段与MenuEntity的id字段不匹配（类型不一致或字段名写错），导致Room无法关联到对应Menu数据，返回null。
• 交叉表MenuCourseCrossRef的关联字段配置错误，导致PopulatedMenu查询失败，进而让PopulatedMeeting的menu字段变为null。

解决方法 #

1. 允许关联字段为可空类型（快速修复）

修改PopulatedMeeting中的menu字段为可空类型，让Room在查询不到对应Menu时返回null，而非触发空指针：

data class PopulatedMeeting(
    @Embedded val meeting: MeetingEntity,
    @Relation(
        parentColumn = "menuId",
        entityColumn = "id",
        entity = MenuEntity::class
    )
    val menu: PopulatedMenu?, // 添加?标记为可空类型
    @Relation(
        parentColumn = "workoutPlanId",
        entityColumn = "id",
        entity = WorkoutPlanEntity::class
    )
    val workoutPlan: PopulatedWorkoutPlan
)

如果workoutPlan也可能出现类似无数据的情况，建议同样改为可空类型。

2. 保证数据完整性（从根源避免问题）

通过数据库外键约束，强制MeetingEntity的menuId必须指向已存在的MenuEntity记录：

@Entity(
    foreignKeys = [
        ForeignKey(
            entity = MenuEntity::class,
            parentColumns = ["id"],
            childColumns = ["menuId"],
            onDelete = ForeignKey.CASCADE // 根据业务需求选择删除策略
        )
    ]
)
data class MeetingEntity(
    @PrimaryKey val id: Long,
    val menuId: Long,
    // 其他业务字段...
)

添加该约束后，数据库会自动阻止插入无对应Menu的Meeting记录，从根源避免查询时出现null的情况。

3. 校验Room关联配置的正确性

• 确认MeetingEntity中确实存在menuId字段，且类型与MenuEntity的id字段完全一致（比如均为Long类型）。
• 检查PopulatedMenu的关联配置，确保交叉表MenuCourseCrossRef的字段名与注解配置完全匹配：

  // 确保MenuCourseCrossRef的字段名和关联配置一致
  data class MenuCourseCrossRef(
      val menu_id: Long,
      val course_id: Long
  )
  
  data class PopulatedMenu(
      @Embedded
      val menu: MenuEntity,
      @Relation(
          parentColumn = "id", // 对应MenuEntity的id
          entityColumn = "id", // 对应CourseEntity的id
          associateBy = Junction(
              value = MenuCourseCrossRef::class,
              parentColumn = "menu_id", // 对应MenuCourseCrossRef的menu_id
              entityColumn = "course_id" // 对应MenuCourseCrossRef的course_id
          ),
          entity = CourseEntity::class
      )
      val courses: List<PopulatedCourse>
  )
  

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