Flutter升级后出现'Widget'类型转换不兼容错误求助

错误信息 #

'Widget' is not a subtype of type 'Widget'

控制台堆栈信息 #

══╡ EXCEPTION CAUGHT BY WIDGETS LIBRARY ╞═══════════════════════════════════════════════════════════
The following _TypeError was thrown building StreamBuilder<User>(dirty, state:
_StreamBuilderBaseState<User, AsyncSnapshot<User>>#aebd2):
type '({required BuildContext context, required Post post, required String postIdentifier, required
KNPostDisplayContext displayContext, required (Post) => void onPostDeleted}) => Widget' is not a
subtype of type '({BuildContext context, KNPostDisplayContext displayContext, (Post) => void
onPostDeleted, Post post, String postIdentifier}) => Widget' in type cast

相关Widget代码 #

Widget _buildVisibleProfileContent() {
  return Column(
    mainAxisSize: MainAxisSize.max,
    children: [
      Expanded(
        child: KNPostsStream(
            streamIdentifier: 'profile_${widget.user.username}',
            displayContext: _postsDisplayContext,
            prependedItems: _buildProfileContentDetails(),
            controller: _obPostsStreamController,
            postBuilder: _buildPostsStreamPost as KNPostsStreamPostBuilder,
            secondaryRefresher: _refreshUser,
            refresher: _refreshPosts,
            onScrollLoader: _loadMorePosts,
            onPostsRefreshed: _onPostsRefreshed,
            statusIndicatorBuilder: _buildPostsStreamStatusIndicator),
      ),
    ],
  );
}

问题定位 #

错误触发行：

postBuilder: _buildPostsStreamPost as KNPostsStreamPostBuilder,

环境信息 #

• Flutter版本：3.10.1
• pubspec.yaml环境配置：

environment:
sdk: ">=2.12.0 <3.0.0"

补充post_streams.dart代码 #

final KNPostsStreamPostBuilder? postBuilder;

List<Widget> _buildStreamPosts() {
  KNPostsStreamPostBuilder postBuilder =
      widget.postBuilder ?? _defaultStreamPostBuilder;

typedef KNPostsStreamPostBuilder = Widget Function(
    {BuildContext context,
    Post post,
    KNPostDisplayContext displayContext,
    String postIdentifier,
    ValueChanged<Post> onPostDeleted});  

问题原因 #

核心问题是函数类型的命名参数required修饰符不匹配：

• 你的_buildPostsStreamPost实现函数给所有参数加了required修饰
• 但KNPostsStreamPostBuilder typedef定义里的参数没有required修饰

Flutter 3.x版本对函数类型匹配的校验更严格，旧版本未严格校验这一点，所以之前无报错。另外pubspec.yaml的SDK版本范围与实际使用的Dart 3.x版本不匹配，也会引发潜在兼容性问题。

解决步骤 #

1. 统一参数修饰符
   两种方案二选一：

   • 方案一：给typedef的参数添加required
     修改post_streams.dart中的typedef：

     typedef KNPostsStreamPostBuilder = Widget Function(
         {required BuildContext context,
         required Post post,
         required KNPostDisplayContext displayContext,
         required String postIdentifier,
         required ValueChanged<Post> onPostDeleted});  
     

   • 方案二：移除_buildPostsStreamPost函数参数的required修饰，确保与typedef完全一致。

2. 修正SDK版本范围
   Flutter 3.10.1对应Dart 3.0.1，更新pubspec.yaml：

   environment:
     sdk: ">=3.0.0 <4.0.0"
   

3. 移除冗余类型转换
   参数类型匹配后，无需强制类型转换：

   postBuilder: _buildPostsStreamPost,
   

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