Android Room多对多关联查询返回空值，求问题原因

以下是导致getStationWithSubways()返回空值的常见原因及对应排查、解决方法：

• 交叉表未插入关联数据
  Room多对多关联完全依赖StationSubwayCrossRefEntity这类交叉表建立映射关系。如果只插入了StationEntity和SubwayEntity的数据，却没有往交叉表中添加对应的关联记录，查询时自然找不到匹配的关联数据，甚至会返回空列表。
  解决：插入数据时同步添加交叉表记录，示例代码：

  // 插入基础数据
  stationDao.insertStation(StationEntity("XX地铁站"))
  stationDao.insertSubway(SubwayEntity(1))
  // 插入关联映射
  stationDao.insertCrossRef(StationSubwayCrossRefEntity("XX地铁站", 1))
  

• DAO查询方法未添加@Transaction注解
  Room的@Relation注解要求查询必须在事务中执行，否则无法正确完成多表关联查询，最终返回空值。
  检查DAO接口中的查询方法，确保添加@Transaction：

  @Dao
  interface StationDao {
      @Transaction
      @Query("SELECT * FROM StationEntity")
      fun getStationWithSubways(): List<StationWithSubwaysEntity>
  }
  

• 数据库表结构异常（迁移问题）
  如果是中途新增的交叉表，但未更新数据库版本或编写迁移脚本，会导致交叉表实际不存在于数据库中，关联记录插入失败，进而查询无结果。
  解决：

  1. 更新@Database注解中的version版本号
  2. 开发测试阶段可临时开启fallbackToDestructiveMigration()，让Room重建数据库（注意会清空所有数据，仅用于测试）

• 数据匹配存在误差
  检查车站名称、地铁ID的拼写或数值是否完全一致：比如交叉表中的stationName必须和StationEntity的主键完全匹配（大小写、空格都不能出错）；如果查询带条件（比如只查收藏车站），要确保满足条件的车站确实存在关联的地铁数据。

• @Relation参数隐性错误
  再次核对@Relation的参数配置：

  • parentColumn必须对应StationEntity的主键stationName
  • entityColumn必须对应SubwayEntity的主键subwayId
  • 交叉表的parentColumn和entityColumn要严格对应交叉表中的字段名，拼写错误会直接导致关联失败

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