Flutter中使用Floor ORM联查Header/Detail表生成失败求助

核心问题：返回类型不明确 #

Floor ORM要求DAO查询方法必须指定具体的实体类型，你当前使用的Future<List>属于无界泛型，不符合Floor的类型校验规则，这是「Can not define return type」报错的直接原因。此外，联表查询返回自定义实体时，还需确保SQL结果能正确映射到目标类。

步骤1：定义明确的自定义实体类 #

创建用于接收联表查询结果的DTO类（无需添加@Entity注解，因为它不是数据库表），并实现从查询结果映射的方法：

class SalesOrderFull {
  final String orderNo;
  final DateTime orderDate;
  final String productName;
  final int quantity;

  SalesOrderFull({
    required this.orderNo,
    required this.orderDate,
    required this.productName,
    required this.quantity,
  });

  // 从数据库查询结果映射到实体
  factory SalesOrderFull.fromMap(Map<String, dynamic> map) {
    return SalesOrderFull(
      orderNo: map['order_no'] as String,
      orderDate: DateTime.parse(map['order_date'] as String),
      productName: map['product_name'] as String,
      quantity: map['quantity'] as int,
    );
  }
}

步骤2：修正DAO方法的返回类型与SQL语句 #

将DAO方法的返回类型改为Future<List<SalesOrderFull>>，同时确保SQL查询的列名（或别名）与自定义实体的字段名完全匹配：

@Dao()
abstract class SalesOrderDao {
  @Query('''
    SELECT 
      soh.order_no, soh.order_date, 
      sod.product_name, sod.quantity
    FROM sales_order_hd soh
    JOIN sales_order_dt sod ON soh.order_no = sod.order_no
  ''')
  Future<List<SalesOrderFull>> getFullSalesOrders();
}

步骤3：重新执行构建命令 #

运行以下命令生成Floor所需的代码：

flutter pub run build_runner build --delete-conflicting-outputs

额外注意事项 #

• 若SQL查询的列名与实体字段名不一致，必须用AS指定别名，例如soh.order_number AS orderNo。
• 确保查询结果的字段类型与实体类字段类型完全匹配（如数据库日期类型需转成DateTime，数字类型对应int/double）。

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