背景

我们知道，在软件开发过程中，错误和异常总是在所难免。

不管是客户端的逻辑错误导致的，还是服务器的数据问题导致的，只要出现了异常，我们都需要一个机制来通知我们去处理。

在 APP 的开发过程中，我们通过一些第三方的平台，比如 Fabric、Bugly 等可以实现异常的日志上报。

Flutter 也有一些第三方的平台，比如 Sentry 可以实现异常的日志上报。

但是为了更加通用一些，本篇不具体讲解配合某个第三方平台的异常日志捕获，我们会告知大家如何在 Flutter 里面捕获异常。

至于具体的上报途径，不管是上报到自家的后台服务器，还是通过第三方的 SDK API 接口进行异常上报，都是可以的。

Demo 初始状态

首先我们新建 Flutter 项目，修改 main.dart 代码如下：

import 'package:flutter/material.dart';  void main() => runApp(MyApp());  class MyApp extends StatelessWidget {   // This widget is the root of your application.   @override   Widget build(BuildContext context) {     return MaterialApp(       home: Scaffold(         appBar: AppBar(title: Text('Flutter Crash Capture'),),         body: MyHomePage(),       ),     );   } }  class MyHomePage extends StatelessWidget {   @override   Widget build(BuildContext context) {     return Container();   } }

效果如下：

捕获错误

我们修改 MyHomePage，添加一个 List 然后进行越界访问，改动部分代码如下：

class MyHomePage extends StatelessWidget {  @override  Widget build(BuildContext context) {    List<String> numList = ['1', '2'];    print(numList[6]);    return Container();  } }

可以看到控制台报错如下：

flutter: ══╡ EXCEPTION CAUGHT BY WIDGETS LIBRARY ╞═══════════════════════════════════════════════════════════ flutter: The following RangeError was thrown building MyHomePage(dirty): flutter: RangeError (index): Invalid value: Not in range 0..1, inclusive: 6

当然这些错误信息在界面上也有显示（debug 模式）。

那么我们如何捕获呢？

其实很简单，有个通用模板，模板为：

import 'dart:async';  import 'package:flutter/material.dart';  Future<Null> main() async {   FlutterError.onError = (FlutterErrorDetails details) async {     Zone.current.handleUncaughtError(details.exception, details.stack);   };    runZoned<Future<void>>(() async {     runApp(MyApp());   },  onError: (error, stackTrace) async {     await _reportError(error, stackTrace);   }); }  Future<Null> _reportError(dynamic error, dynamic stackTrace) async {   // TODO }

在 TODO 里面就可以执行埋点上报操作或者其他处理了。

完整例子如下：

import 'dart:async';  import 'package:flutter/material.dart';  Future<Null> main() async {   FlutterError.onError = (FlutterErrorDetails details) async {     Zone.current.handleUncaughtError(details.exception, details.stack);   };    runZoned<Future<void>>(() async {     runApp(MyApp());   },  onError: (error, stackTrace)