Flutter中使用web3dart连接Web3 Client时出现错误

问题场景 #

在Flutter项目中尝试初始化Web3 Client时出现编译错误，相关代码如下：

import 'dart:html';
import 'package:web3dart/web3dart.dart';

import 'package:flutter/material.dart';

class Home extends StatefulWidget {
  const Home({super.key});

  @override
  State<Home> createState() => _HomeState();
}

class _HomeState extends State<Home> {
  Client? httpClient;
  Web3Client? ethClient;

  @override
  Widget build(BuildContext context) {
    return Container();
  }
}

错误及解决方案 #

错误1：Target of URI doesn't exist: 'package:web3dart/web3dart.dart' #

系统提示：尝试创建URI引用的文件，或使用存在的文件对应的URI。（错误码：darturi_does_not_exist）

解决步骤：

• 打开项目根目录下的pubspec.yaml，在dependencies中添加web3dart依赖：

  dependencies:
    web3dart: ^2.7.0 # 可替换为最新稳定版本
  

• 执行终端命令flutter pub get，完成依赖包拉取
• 检查导入语句拼写，确保路径和包名完全正确

错误2：Undefined class 'Web3Client' #

系统提示：尝试将名称改为现有类的名称，或创建名为'Web3Client'的类。（错误码：dartundefined_class）

解决步骤：

• 确保web3dart依赖已通过flutter pub get成功安装，未安装依赖会导致IDE无法识别该类
• 确认类名拼写正确，Web3Client是web3dart包中的标准类名，注意大小写区分
• 若为跨平台项目，dart:html仅支持Web环境，移动端需改用http包创建客户端：

  import 'package:http/http.dart' as http;
  import 'package:web3dart/web3dart.dart';
  
  // 初始化Web3客户端示例
  void initWeb3Client() {
    final httpClient = http.Client();
    ethClient = Web3Client('https://your-rpc-node-url', httpClient);
  }
  

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