Flutter使用Riverpod时无法访问状态变量及copyWith方法问题

问题描述 #

当前Flutter项目中，使用Freezed定义的HomePageState状态类，出现无法访问isLoading以外的状态变量，且copyWith方法不被识别的异常。此前未出现此类问题，需排查原因。

相关代码 #

状态类（homePageState.dart） #

import 'package:freezed_annotation/freezed_annotation.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';

part 'homePageState.freezed.dart';

@freezed
class HomePageState with _$HomePageState {
  const factory HomePageState({
    @Default(true) bool isLoading,
    @Default(CameraPosition(target: LatLng(0, 0), zoom: 14)) CameraPosition cameraPosition,
    @Default([]) List<Marker> myMarker,
    @Default([
    Marker(
        markerId: MarkerId('First'),
        position: LatLng(22.644022415585223, 88.42673328033993),
        infoWindow: InfoWindow(title: 'Home')),
    Marker(
        markerId: MarkerId('Second'),
        position: LatLng(22.643450, 88.427420),
        infoWindow: InfoWindow(title: 'Home'))
  ]) List<Marker> markerList
  }) = _HomePageState;

  const HomePageState._();
}

通知类（HomePageNotifier） #

class HomePageNotifier extends StateNotifier<HomePageState> {
  final Completer<GoogleMapController> controller = Completer();

  HomePageNotifier() : super(HomePageState());


  void addMarkers() {
    // myMarker.addAll(markerList);
    state = state.copyWith     // 此处无法访问copyWith方法，也无法访问isLoading以外的状态变量
  }
}

final homePageNotifier = StateNotifierProvider.autoDispose<HomePageNotifier, HomePageState>((ref) => HomePageNotifier());

pubspec.yaml片段 #

dependencies:
  flutter:
    sdk: flutter
  flutter_riverpod: ^2.4.9
  google_maps_flutter: ^2.5.3
  geocoding: ^2.1.1
  geolocator: ^10.1.0
  json_annotation: ^4.8.1

  cupertino_icons: ^1.0.2

dev_dependencies:
  flutter_test:
    sdk: flutter
  freezed: ^2.4.6
  build_runner: ^2.4.8  
  json_serializable: ^6.7.1
  freezed_annotation: ^2.4.1
  json_annotation: ^4.8.1

排查与解决方案 #

1. 修复状态类语法错误 #

状态类中markerList参数末尾缺少逗号，这是导致Freezed无法正确解析类结构的核心问题，直接影响copyWith方法和变量访问器的生成。修正后的代码如下：

const factory HomePageState({
    @Default(true) bool isLoading,
    @Default(CameraPosition(target: LatLng(0, 0), zoom: 14)) CameraPosition cameraPosition,
    @Default([]) List<Marker> myMarker,
    @Default([
    Marker(
        markerId: MarkerId('First'),
        position: LatLng(22.644022415585223, 88.42673328033993),
        infoWindow: InfoWindow(title: 'Home')),
    Marker(
        markerId: MarkerId('Second'),
        position: LatLng(22.643450, 88.427420),
        infoWindow: InfoWindow(title: 'Home'))
  ]) List<Marker> markerList, // 此处添加逗号
  }) = _HomePageState;

2. 重新生成Freezed代码 #

执行以下命令重新生成Freezed相关文件：

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

如果生成文件仍有问题，可先删除项目根目录下的.dart_tool文件夹，再重新执行上述命令。

3. 检查依赖与IDE缓存 #

• 确保freezed和freezed_annotation版本兼容，当前pubspec中的版本组合可行，执行flutter pub get确保依赖完全安装。
• 重启IDE并清理缓存（VS Code按Ctrl+Shift+P选择"Reload Window"，Android Studio选择"File -> Invalidate Caches..."），避免IDE索引异常导致的代码识别错误。

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