如何在应用崩溃时将完整日志栈上报至Firebase Crashlytics？

方法1：自定义Timber Tree对接Crashlytics #

既然项目大量使用Timber，最直接的方式是自定义一个Timber Tree，将所有Timber日志转发到Firebase Crashlytics的日志系统，这样崩溃时这些日志会自动关联到崩溃记录中。

实现代码示例（Kotlin）：

class CrashlyticsTree : Timber.Tree() {
    override fun log(priority: Int, tag: String?, message: String, t: Throwable?) {
        // 映射Android日志级别到Crashlytics对应级别
        val crashlyticsLevel = when (priority) {
            Log.VERBOSE, Log.DEBUG -> FirebaseCrashlytics.LogLevel.DEBUG
            Log.INFO -> FirebaseCrashlytics.LogLevel.INFO
            Log.WARN -> FirebaseCrashlytics.LogLevel.WARNING
            Log.ERROR, Log.ASSERT -> FirebaseCrashlytics.LogLevel.ERROR
            else -> FirebaseCrashlytics.LogLevel.DEBUG
        }
        // 将日志写入Crashlytics缓存
        FirebaseCrashlytics.getInstance().log(crashlyticsLevel, tag ?: "UnknownTag", message)
        // 若有异常对象，同时记录（非崩溃场景也能关联，崩溃时会整合进堆栈）
        t?.let { FirebaseCrashlytics.getInstance().recordException(it) }
    }
}

在Application的onCreate中初始化Timber时添加这个Tree：

Timber.plant(CrashlyticsTree())

方法2：统一处理系统Log.XX调用 #

对于直接使用Log.d/Log.i等系统API的场景，建议封装一个自定义Log工具类，将日志同时输出到系统Log和Crashlytics，逐步替换原有调用：

示例代码（Java）：

public class AppLog {
    public static void d(String tag, String message) {
        Log.d(tag, message);
        FirebaseCrashlytics.getInstance().log(FirebaseCrashlytics.LogLevel.DEBUG, tag, message);
    }

    public static void e(String tag, String message, Throwable throwable) {
        Log.e(tag, message, throwable);
        FirebaseCrashlytics.getInstance().log(FirebaseCrashlytics.LogLevel.ERROR, tag, message);
        FirebaseCrashlytics.getInstance().recordException(throwable);
    }

    // 按需实现info、warn等其他日志级别方法
}

如果不想大规模替换代码，也可以通过反射拦截系统Log的输出，但这种方式存在兼容性风险，不推荐在生产环境使用。

方法3：优化Crashlytics日志缓存策略 #

Crashlytics默认会缓存最近的日志内容，但默认可能只保留ERROR级别以上的日志。配合上面的日志转发方案，确保所有需要的日志都被写入Crashlytics缓存，崩溃时这些日志会和堆栈跟踪一起上报。

关键注意事项 #

• 日志量控制：Crashlytics对单条崩溃记录的日志大小有限制，过多日志会被截断，生产环境建议只保留关键流程和错误相关的日志，避免打印冗余信息。
• 敏感信息防护：严禁在日志中打印用户隐私、授权Token、银行卡信息等敏感内容，避免合规风险。
• 测试验证：发布前在测试环境主动触发崩溃，检查Crashlytics后台是否能看到完整的崩溃前置日志，确保方案生效。

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