使用Room的@Relation注解无法获取正确关联数据问题

核心问题定位 #

你的问题根源在于关联数据类的注解逻辑完全颠倒，同时DAO的SQL查询与Room的@Relation机制冲突，导致数据匹配错误和重复。

具体错误分析 #

1. 注解位置与关联列配置错误
   当前DocumentProductWithDetails中，你把@Embedded用在ProductWithBarcodes（关联详情）上，@Relation用在DocumentProduct（主实体）上，这完全违背了Room的关联逻辑：

   • @Embedded应该标记主实体（即DAO查询的核心表条目，这里是document_products对应的DocumentProduct）
   • @Relation用于标记从主实体关联的子数据（这里是ProductWithBarcodes）
   • 关联列配置错误：你用DocumentProduct的主键id去关联其他表的productId，正确逻辑应该是用DocumentProduct的productId去关联Product的id

2. 手动JOIN与@Relation冲突
   你在DAO中手动写了多表LEFT JOIN，而Room的@Relation会自动执行关联查询，手动JOIN返回的重复行（比如一个商品对应多个条码时会生成多行）会被Room错误解析，导致重复对象生成。

修正方案 #

1. 修正关联数据类注解

@JsonClass(generateAdapter = true)
data class DocumentProductWithDetails(
    @Embedded // 主实体：document_products表的条目
    var product: DocumentProduct,
    @Relation(
        parentColumn = "productId", // 主实体的关联字段：DocumentProduct.productId
        entityColumn = "id"         // 子实体的关联字段：Product.id
    )
    var details: ProductWithBarcodes?
)

2. 简化DAO查询语句

删除手动多表JOIN，让Room通过@Relation自动处理关联，避免重复行问题：

@Transaction
@Query("SELECT * FROM document_products WHERE documentId = :documentId ORDER BY timestamp ASC")
fun getProductsWithDetails(documentId: Long): Flow<List<DocumentProductWithDetails>>

3. 保留正确的子关联逻辑

ProductWithBarcodes的注解是正确的，无需修改：

data class ProductWithBarcodes(
    @Embedded
    var product: Product,
    @Relation(
        parentColumn = "id",
        entityColumn = "productId"
    )
    var barcodes: List<Barcode>
)

修正逻辑说明 #

• 修正后，Room会先执行DAO的查询获取指定documentId下的所有DocumentProduct条目
• 再自动根据每个DocumentProduct的productId，关联查询对应的Product和其下属的Barcode列表
• 最终将主实体与关联子数据合并为一个DocumentProductWithDetails对象，彻底解决重复和匹配错误问题

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