Firebase日志收集：Try-Catch中捕获的Exception能否自动上报？需手动调用吗？

1. 默认行为：需手动上报 #

Firebase Crashlytics（或Analytics）默认仅自动上报未被捕获的崩溃级异常。对于try-catch块中主动捕获的Exception，系统无法自动感知，必须手动调用上报API。

示例代码：

Android #

try {
    // 可能抛出异常的业务代码
} catch (Exception e) {
    // 手动上报到Crashlytics
    FirebaseCrashlytics.getInstance().recordException(e);
    // 如需记录业务上下文，可结合Analytics
    Bundle contextBundle = new Bundle();
    contextBundle.putString("action", "submit_form");
    FirebaseAnalytics.getInstance(context).logEvent("caught_exception", contextBundle);
}

iOS #

do {
    try submitUserData()
} catch let error {
    Crashlytics.crashlytics().record(error: error)
}

2. 实现自动监听上报的方法 #

如果想避免重复手动调用API，可通过以下方式实现全局自动上报：

方式一：封装通用异常处理工具类 #

写一个全局工具方法，包裹所有可能抛出异常的逻辑，内部自动完成上报：

public class ExceptionReporter {
    // 带返回值的方法封装
    public static <T> T executeWithReport(Supplier<T> task) {
        try {
            return task.get();
        } catch (Exception e) {
            FirebaseCrashlytics.getInstance().recordException(e);
            return null; // 或返回业务默认值
        }
    }

    // 无返回值的方法封装
    public static void runWithReport(Runnable task) {
        try {
            task.run();
        } catch (Exception e) {
            FirebaseCrashlytics.getInstance().recordException(e);
        }
    }
}

使用时直接调用：

ExceptionReporter.runWithReport(() -> {
    // 可能抛出异常的代码
});

方式二：AOP切面全局拦截（适用于支持AOP的环境） #

通过AspectJ等AOP框架，拦截所有方法的异常抛出点，自动上报捕获的异常：

@Aspect
class GlobalExceptionAspect {
    @AfterThrowing(pointcut = "execution(* com.yourpackage..*(..))", throwing = "e")
    fun reportCaughtException(e: Throwable) {
        FirebaseCrashlytics.getInstance().recordException(e)
    }
}

注：需精准配置切点范围，避免上报无关的预期内业务异常。

方式三：扩展UncaughtExceptionHandler（补充未捕获异常） #

虽然Firebase默认已处理未捕获异常，但可自定义处理器补充上下文信息：

Thread.UncaughtExceptionHandler defaultHandler = Thread.getDefaultUncaughtExceptionHandler();
Thread.setDefaultUncaughtExceptionHandler((thread, throwable) -> {
    FirebaseCrashlytics.getInstance().setCustomKey("thread_name", thread.getName());
    FirebaseCrashlytics.getInstance().recordException(throwable);
    // 执行默认崩溃逻辑
    defaultHandler.uncaughtException(thread, throwable);
});

注意事项 #

• 上报时建议添加业务上下文（如用户操作、页面路径），便于后续排查问题；
• 避免上报预期内的业务异常（如输入格式错误），防止日志冗余。

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