Flutter中graphql包编译报错：GraphQLWebSocketChannel未实现成员

在Flutter项目中接入GraphQL API，指定安装graphql: ^5.1.1和graphql_flutter: ^5.1.0后编译报错：非抽象类GraphQLWebSocketChannel缺少WebSocketChannel.ready成员的实现。且报错引用的是本地缓存中的高版本graphql-5.1.2，而非指定版本。已尝试调整SDK版本、执行pod deintegrate、pod install、flutter clean、flutter pub cache repair等操作，均未解决。

错误信息 #

Writing result bundle at path:
    /var/folders/71/5s_xdvm50d1bcj4q8zf_41j40000gp/T/flutter_tools.l4Y5sf/flutter_ios_build_temp_dir1J1YUm/t
    emporary_xcresult_bundle

../../flutter/.pub-cache/hosted/pub.dartlang.org/graphql-5.1.2/lib/src/links/websocket_link/websocket_cli
ent.dart:577:7: Error: The non-abstract class 'GraphQLWebSocketChannel' is missing implementations for
these members:
 - WebSocketChannel.ready
Try to either
 - provide an implementation,
 - inherit an implementation from a superclass or mixin,
 - mark the class as abstract, or
 - provide a 'noSuchMethod' implementation.

class GraphQLWebSocketChannel extends StreamChannelMixin<dynamic>
      ^^^^^^^^^^^^^^^^^^^^^^^
../../flutter/.pub-cache/hosted/pub.dartlang.org/web_socket_channel-2.3.0/lib/src/channel.dart:56:22:
Context: 'WebSocketChannel.ready' is defined here.
  final Future<void> ready = Future.value();
                     ^^^^^
Failed to package /Users/nazehabel/mobile-projects/aysquared.
Command PhaseScriptExecution failed with a nonzero exit code
note: Building targets in dependency order

项目pubspec.yaml配置 #

description: A new Flutter project.

module:
  androidX: true
publish_to: 'none' # Remove this line if you wish to publish to pub.dev

version: 1.0.0

environment:
  sdk: '>=2.17.5 <4.0.0'
  flutter: '>=2.5.3 <3.0.0'
dependencies:
  cupertino_icons: ^1.0.2
  dio: ^4.0.6
  file_picker: ^5.2.4
  flutter:
    sdk: flutter
  flutter_dotenv: ^5.0.2
  flutter_riverpod: ^2.0.2
  flutter_screenutil: ^5.6.0
  flutter_secure_storage: ^7.0.1
  flutter_smart_dialog: ^4.8.0
  flutter_spinkit: ^5.1.0
  flutter_svg: ^1.1.6
  freezed: ^2.2.1
  freezed_annotation: ^2.2.0
  get_it: ^7.2.0
  hooks_riverpod: ^2.1.1
  image_picker: ^0.8.6
  intl: ^0.17.0
  intl_phone_number_input: ^0.7.1
  oktoast: ^3.3.1
  provider: ^6.0.5
  riverpod_annotation: ^1.0.4
  sliding_up_panel: ^2.0.0+1
  timer_count_down: ^2.2.1
  url_launcher: ^6.1.7
  visibility_detector: ^0.3.3
  syncfusion_flutter_charts: ^20.4.42
  syncfusion_localizations: ^20.4.42
  desktop_window: ^0.4.0
  localization: ^2.1.0
  flutter_localizations:
    sdk: flutter
  fl_chart: ^0.55.2
  percent_indicator: ^4.2.2
  charts_flutter: ^0.12.0
  pinput: ^2.2.21
  google_fonts: ^3.0.1
  dropdown_button2: ^1.9.2
  dotted_line: ^3.1.0
  flutter_staggered_grid_view: ^0.6.2
  trash_themes: ^0.0.2
  graphql: ^5.1.1
  graphql_flutter: ^5.1.0


flutter_native_splash:
  android: true
  ios: true
  image: assets/images/logo-white.png
  android_gravity: center
  ios_content_mode: center
  color: "#FFFFFF"

dev_dependencies:
  flutter_test:
    sdk: flutter

  build_runner: ^2.3.2
  riverpod_generator: ^1.0.4
  flutter_native_splash: ^2.1.6
  flutter_lints: ^2.0.0
flutter:

 
  uses-material-design: true

  # To add assets to your application, add an assets section, like this:
  assets:
    # - assets/images
    - .env
    - assets/images/
    - assets/images/categories_images/
    - assets/images/grocery_images/
    - assets/images/beverages_images/
    - assets/icons/
    - assets/icons/account_icons/
    - assets/fonts/

  fonts:
    - family: Gilroy
      fonts:
        - asset: assets/fonts/gilroy/Gilroy-Regular.ttf
        - asset: assets/fonts/gilroy/Gilroy-SemiBold.ttf
        - asset: assets/fonts/gilroy/Gilroy-Bold.otf

问题根源是graphql_flutter: ^5.1.0的依赖范围允许拉取更高版本的graphql，而graphql-5.1.2与web_socket_channel:2.3.0存在兼容性冲突。按以下步骤处理：

1. 锁定graphql精确版本
   修改pubspec.yaml中的依赖，将graphql: ^5.1.1改为graphql: 5.1.1（去掉^符号，强制使用指定版本），避免pub自动升级到更高版本。

2. 清理并重新获取依赖
   执行以下命令彻底清理旧依赖：

   flutter clean
   rm -rf pubspec.lock
   flutter pub get
   

3. 修复iOS端依赖
   进入项目的ios目录，执行以下命令重置Pod依赖：

   pod deintegrate
   rm Podfile.lock
   pod install
   

4. 强制指定兼容的web_socket_channel版本
   如果上述步骤无效，在pubspec.yaml的dependencies中添加web_socket_channel: 2.2.0（该版本与graphql-5.1.1完全兼容）：

   dependencies:
     # ...其他依赖项
     web_socket_channel: 2.2.0
   

5. 验证依赖版本
   执行flutter pub deps查看依赖树，确认graphql版本为5.1.1，且web_socket_channel版本不高于2.2.0。

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