Flutter突然出现'Undefined name 'context''错误的解决求助

问题重现 #

在State类的showPaywall方法中使用context时，出现Undefined name 'context'错误，且所有build方法外需要BuildContext的方法都报此错，此前运行正常，已尝试清理缓存、重装/降级Flutter和Dart扩展。

代码示例 #

void showPaywall() async {
    setState(() {
      // _isLoading = true;
    });

    CustomerInfo customerInfo = await Purchases.getCustomerInfo();

    if (customerInfo.entitlements.all[entitlementID] != null &&
        customerInfo.entitlements.all[entitlementID]?.isActive == true) {
      setState(() {
        // _isLoading = false;
        alreadySubscribed();
      });
    } else {
      Offerings? offerings;
      try {
        offerings = await Purchases.getOfferings();
      } on PlatformException catch (error) {
        errorMessage(error);
      }

      setState(() {
        // _isLoading = false;
      });

      if (offerings == null || offerings.current == null) {
        // offerings are empty, show a message to your user
      } else {
        // current offering is available, show paywall
        if (!mounted) return;
        await showModalBottomSheet(
          useRootNavigator: true,
          isDismissible: true,
          isScrollControlled: true,
          backgroundColor: Colors.black,
          shape: const RoundedRectangleBorder(
            borderRadius: BorderRadius.vertical(top: Radius.circular(25.0)),
          ),
          context: context, // 此处报Undefined name 'context'错误
          builder: (BuildContext context) {
            return StatefulBuilder(
                builder: (BuildContext context, StateSetter setModalState) {
              return Paywall(
                offering: offerings!.current!,
              );
            });
          },
        );
      }
    }
  }

解决步骤 #

• 确认State类的泛型绑定正确：你的State类必须是class _YourWidgetState extends State<YourWidget>，泛型缺失或错误会导致context无法被分析器识别。
• 检查方法定义位置：确保showPaywall等方法是直接定义在State类内部，没有被嵌套到其他类或函数中。
• 重启Dart分析服务器：在VS Code中按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Dart: Restart Analysis Server执行，修复分析器缓存异常。
• 刷新依赖并重启项目：执行flutter pub get刷新依赖，然后完全重启IDE和项目。
• 清理项目缓存文件：删除项目根目录下的.dart_tool、build文件夹（如果用Android Studio还可以删除.idea），之后重新构建项目。
• 切换到Flutter稳定版：执行flutter channel stable和flutter upgrade，避免beta/dev版本的分析器bug。

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