Flutter Hooks 中 ExpansionTileController 使用陷阱与解决方案

引言

在使用 Flutter Hooks 开发过程中，许多开发者会遇到 ExpansionTile 组件与控制器结合使用时的一些棘手问题。本文将深入分析 ExpansionTileController 在 Flutter Hooks 环境下的正确使用方式，揭示常见错误背后的原理，并提供可靠的解决方案。

问题现象分析

当开发者尝试在 HookWidget 中使用 useExpansionTileController 钩子时，经常会遇到以下错误：

'package:flutter/src/material/expansion_tile.dart': Failed assertion: line 49 pos 12: '_state != null': is not true.

这个断言错误表明 ExpansionTileController 在被访问时尚未与实际的 widget 状态关联。本质上，这是 Flutter 框架层面的保护机制，而非 flutter_hooks 包的问题。

核心问题解析

问题的根源在于 ExpansionTileController 的生命周期管理。在 Flutter 中，控制器类通常需要与具体的 widget 实例绑定后才能正常工作。当我们直接在 build 方法中访问控制器的属性时，可能会遇到以下时序问题：

1. 控制器实例已创建
2. 但尚未与 ExpansionTile widget 关联
3. 此时访问 isExpanded 属性就会触发断言错误

错误使用模式

以下是典型的错误使用方式：

@override
Widget build(BuildContext context) {
  final controller = useExpansionTileController();
  return ExpansionTile(
    controller: controller,
    trailing: controller.isExpanded ? Icon(Icons.remove) : Icon(Icons.add),
    // ...
  );
}

这种写法的问题在于控制器状态被同步访问，而此时控制器可能尚未准备好。

解决方案一：使用 Builder 延迟访问

最可靠的解决方案是使用 Builder widget 来延迟对控制器状态的访问：

@override
Widget build(BuildContext context) {
  final controller = useExpansionTileController();
  return ExpansionTile(
    controller: controller,
    trailing: Builder(
      builder: (context) {
        final ctrl = ExpansionTileController.of(context);
        return ctrl.isExpanded ? Icon(Icons.remove) : Icon(Icons.add);
      },
    ),
    // ...
  );
}

这种方法利用了 Flutter 的上下文机制，确保只在 widget 树构建完成后才访问控制器状态。

解决方案二：使用状态管理替代

如果上述方法在特定场景下不适用，可以考虑使用更传统的状态管理方式：

@override
Widget build(BuildContext context) {
  final isExpanded = useState(false);
  return ExpansionTile(
    onExpansionChanged: (expanded) => isExpanded.value = expanded,
    trailing: isExpanded.value ? Icon(Icons.remove) : Icon(Icons.add),
    // ...
  );
}

这种方法虽然简单直接，但失去了使用控制器的某些高级功能。

最佳实践建议

1. 理解控制器生命周期：牢记控制器需要与 widget 绑定后才能使用
2. 避免同步状态访问：不要在 build 方法中直接访问控制器状态
3. 考虑使用监听：如果控制器支持监听，应该添加适当的监听器
4. 错误处理：对可能出现的断言错误做好防御性编程

结论

在 Flutter Hooks 中使用 ExpansionTileController 需要特别注意控制器的生命周期管理。通过 Builder 模式或适当的状态管理策略，可以避免常见的断言错误，实现稳定可靠的展开/折叠功能。理解这些底层机制不仅能解决当前问题，也能帮助开发者在面对类似控制器相关问题时更快找到解决方案。