Flutter Widget测试在Ubuntu系统中无法正常完成的问题排查与解决请求

看起来你遇到的问题在Linux桌面Flutter测试场景里挺常见的，结合你描述的两种测试场景和代码情况，我整理了几个针对性的解决方案，你可以一步步尝试：

一、先解决测试无限加载的问题：优化异步处理逻辑 #

你的代码在Windows能正常跑，但Linux上卡住，很大概率是真实SharedPreferences的本地IO操作阻塞了测试事件循环，或者UI渲染的异步流程没等待完成就开始断言。

1. Mock SharedPreferences，避免真实IO操作 #

Linux上的SharedPreferences会读写本地文件，测试环境下这个操作可能因为权限、文件锁等问题卡住。换成mock实例就能绕开这个问题：

import 'package:shared_preferences/shared_preferences.dart';

testWidgets('Counter increments smoke test', (WidgetTester tester) async {
  // 初始化mock的SharedPreferences，避免真实文件读写
  SharedPreferences.setMockInitialValues({});
  final pref = await SharedPreferences.getInstance();

  await tester.pumpWidget(ProviderScope(
    overrides: [
      settingsProvider.overrideWithValue(
        SettingsService(pref),
      ),
    ],
    child: const MyApp(),
  ));

  // 等待所有异步渲染、初始化流程完成，不要只调用pumpWidget
  await tester.pumpAndSettle();

  expect(find.text('1'), findsNothing);
});

2. 用runAsync包裹异步测试逻辑（可选） #

如果还是卡住，试试用tester.runAsync()包裹测试代码，确保异步操作在测试的事件循环里正确执行，同时添加超时限制定位阻塞点：

testWidgets('Counter increments smoke test', (WidgetTester tester) async {
  await tester.runAsync(() async {
    SharedPreferences.setMockInitialValues({});
    final pref = await SharedPreferences.getInstance();

    await tester.pumpWidget(ProviderScope(
      overrides: [
        settingsProvider.overrideWithValue(SettingsService(pref)),
      ],
      child: const MyApp(),
    ));

    await tester.pumpAndSettle(const Duration(seconds: 3));
    expect(find.text('1'), findsNothing);
  }, timeout: const Timeout(Duration(seconds: 10)));
});

二、解决"Shell subprocess ended cleanly"报错 #

这个错误通常是因为运行中的应用和测试共享了资源（比如进程锁、Socket端口），导致测试无法启动新的Flutter Shell实例。

1. 测试前彻底关闭所有相关进程 #

执行测试前，手动关闭所有运行中的Flutter应用，包括后台隐藏进程：

# 杀死所有Flutter相关进程
pkill -f "flutter"
# 杀死你的应用进程（替换成你的应用名称）
pkill -f "my-flutter"

2. 重置Flutter测试环境 #

清理缓存并重新构建依赖，确保没有残留的错误状态：

flutter clean
flutter pub get
# 如果你的项目用到了代码生成（比如riverpod_generator、freezed），再执行：
flutter pub run build_runner clean
flutter pub run build_runner build

三、其他排查步骤 #

1. 更新Flutter到最新版本：Linux桌面测试的bug经常在新版本中被修复，执行flutter upgrade试试。
2. 确认Linux桌面测试支持已启用：执行flutter config --enable-linux-desktop，确保桌面测试环境配置正确。
3. 检查测试依赖：确保pubspec.yaml的dev_dependencies里包含flutter_test，如果需要更方便的mock，可以添加shared_preferences_test辅助测试。

按照这些步骤调整后，应该能解决你遇到的测试报错和无限加载问题。

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