跳至主要内容
内容

在 Flutter 中处理错误

内容

Flutter 框架捕获在框架本身触发的回调期间发生的错误，包括构建、布局和绘制阶段遇到的错误。不在 Flutter 回调中发生的错误无法被框架捕获，但您可以通过在 PlatformDispatcher 上设置错误处理程序来处理它们。

Flutter 捕获的所有错误都将路由到 FlutterError.onError 处理程序。默认情况下，这会调用 FlutterError.presentError，后者将错误转储到设备日志中。在从 IDE 运行时，检查器会覆盖此行为，以便错误也可以路由到 IDE 的控制台，从而允许您检查消息中提到的对象。

当构建阶段发生错误时，将调用 ErrorWidget.builder 回调来构建用于替代失败的小部件。默认情况下，在调试模式下，这会显示红色错误消息，在发布模式下，这会显示灰色背景。

当错误在调用栈上没有 Flutter 回调时，它们由 PlatformDispatcher 的错误回调处理。默认情况下，这只会打印错误，而不会执行其他操作。

您可以自定义这些行为，通常通过将它们设置为 void main() 函数中的值。

下面解释了每种错误类型处理。底部有一个代码片段，它处理所有类型的错误。即使您可以直接复制粘贴代码片段，我们也建议您先了解每种错误类型。

Flutter 捕获的错误

#

例如，要使您的应用程序在发布模式下每次 Flutter 捕获错误时立即退出，您可以使用以下处理程序

dart
import 'dart:io';

import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';

void main() {
  FlutterError.onError = (details) {
    FlutterError.presentError(details);
    if (kReleaseMode) exit(1);
  };
  runApp(const MyApp());
}

// The rest of the `flutter create` code...

此处理程序也可用于将错误报告给日志服务。有关更多详细信息，请参阅我们的菜谱章节，了解 将错误报告给服务。

为构建阶段错误定义自定义错误小部件

#

要定义一个自定义错误小部件，以便在构建器无法构建小部件时显示，请使用 MaterialApp.builder。

dart
class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      builder: (context, widget) {
        Widget error = const Text('...rendering error...');
        if (widget is Scaffold || widget is Navigator) {
          error = Scaffold(body: Center(child: error));
        }
        ErrorWidget.builder = (errorDetails) => error;
        if (widget != null) return widget;
        throw StateError('widget is null');
      },
    );
  }
}

Flutter 未捕获的错误

#

考虑一个 onPressed 回调，它调用异步函数，例如 MethodChannel.invokeMethod（或几乎任何插件）。例如

dart
OutlinedButton(
  child: const Text('Click me!'),
  onPressed: () async {
    const channel = MethodChannel('crashy-custom-channel');
    await channel.invokeMethod('blah');
  },
)

如果 invokeMethod 抛出错误，它不会转发到 FlutterError.onError。相反，它将转发到 PlatformDispatcher。

要捕获此类错误，请使用 PlatformDispatcher.instance.onError。

dart
import 'package:flutter/material.dart';
import 'dart:ui';

void main() {
  MyBackend myBackend = MyBackend();
  PlatformDispatcher.instance.onError = (error, stack) {
    myBackend.sendError(error, stack);
    return true;
  };
  runApp(const MyApp());
}

处理所有类型的错误

#

假设您希望在任何异常时退出应用程序，并在小部件构建失败时显示自定义错误小部件 - 您可以根据以下代码片段处理错误

dart
import 'package:flutter/material.dart';
import 'dart:ui';

Future<void> main() async {
  await myErrorsHandler.initialize();
  FlutterError.onError = (details) {
    FlutterError.presentError(details);
    myErrorsHandler.onErrorDetails(details);
  };
  PlatformDispatcher.instance.onError = (error, stack) {
    myErrorsHandler.onError(error, stack);
    return true;
  };
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      builder: (context, widget) {
        Widget error = const Text('...rendering error...');
        if (widget is Scaffold || widget is Navigator) {
          error = Scaffold(body: Center(child: error));
        }
        ErrorWidget.builder = (errorDetails) => error;
        if (widget != null) return widget;
        throw StateError('widget is null');
      },
    );
  }
}

除非另有说明，否则本网站上的文档反映了 Flutter 的最新稳定版本。页面上次更新于 2024-06-24。 查看源代码 或 报告问题.