Flutter iOS端出现_CastError：Contract无法转为Damage类型

错误核心 #

报错行final Damage damage = item as Damage;触发_CastError，说明当前item的实际类型是Contract，无法强制转换为Damage。Android端正常是因为该场景下传入的item确实是Damage类型，而iOS端流程中传入了Contract实例。

可能原因 #

• 路由传参差异：Android和iOS端跳转当前页面时，传入的item类型不一致，iOS端误传了Contract类型对象。
• 数据源解析问题：如果item来自接口/本地存储，iOS端的序列化/反序列化逻辑错误，将本该是Damage的数据解析成了Contract。
• 分支逻辑差异：Android和iOS端的业务分支处理不同，导致进入当前页面时携带的item类型不同。

解决方法 #

1. 先校验再转换，避免崩溃 #

在强制转换前增加类型判断，兼容不同类型的处理逻辑：

if (item is Damage) {
  final Damage damage = item;
  return Scaffold(
    floatingActionButton: FloatingActionButton(
      tooltip: 'Add',
      onPressed: () {
        Navigator.of(context).push(
          MaterialPageRoute(
            builder: (BuildContext context) => AddDocumentsPage(
              damage: damage,
            ),
          ),
        );
      },
      child: Icon(Icons.add),
    ),
    body: DocumentsList(
      attribute: 'date',
      documentable: item,
    ),
  );
} else if (item is Contract) {
  // 适配Contract类型的业务逻辑，比如隐藏新增按钮
  return Scaffold(
    body: DocumentsList(
      attribute: 'date',
      documentable: item,
    ),
  );
} else {
  // 未知类型的兜底处理
  return Scaffold(body: Center(child: Text('无效数据类型')));
}

2. 排查item来源，修复根源问题 #

• 跟踪当前页面的路由跳转逻辑，检查iOS端跳转时传入的item类型，确保和Android端一致，传入Damage实例。
• 如果item来自JSON解析等序列化操作，检查解析代码：比如使用json_serializable时，是否正确通过类型标识区分Damage和Contract，iOS端是否漏处理了类型判断逻辑。

3. 优化页面设计（可选） #

如果页面需要同时支持Damage和Contract类型，可以改用泛型实现，从根源避免类型混淆：

class DocumentsPage<T> extends StatelessWidget {
  final T item;

  const DocumentsPage({super.key, required this.item});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      floatingActionButton: item is Damage 
          ? FloatingActionButton(
              tooltip: 'Add',
              onPressed: () {
                Navigator.of(context).push(
                  MaterialPageRoute(
                    builder: (BuildContext context) => AddDocumentsPage(
                      damage: item as Damage,
                    ),
                  ),
                );
              },
              child: Icon(Icons.add),
            )
          : null,
      body: DocumentsList(
        attribute: 'date',
        documentable: item,
      ),
    );
  }
}

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