如何在Android设备本地保存应用日志并在崩溃时查看？

一、现成第三方应用 #

• Logcat Reader：支持按包名过滤目标应用日志，可将筛选后的日志导出为TXT/CSV格式，崩溃后直接打开应用即可查看专属日志，无需处理全系统冗余内容。
• CatLog：主打轻量日志筛选，能快速定位指定包名的运行日志，提供一键保存功能，崩溃后可直接调阅已存储的应用日志记录。

二、可集成的代码库 #

1. Timber（Square出品） #

可自定义日志输出逻辑，轻松实现本地文件存储：

• 添加依赖（build.gradle）：

implementation 'com.jakewharton.timber:timber:5.0.1'

• 自定义日志写入类：

public class FileLoggingTree extends Timber.Tree {
    private static final String LOG_DIR = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS) + "/MyAppLogs/";
    private static final String LOG_FILE = "app_runtime_logs.txt";

    @Override
    protected void log(int priority, String tag, String message, Throwable t) {
        try {
            File logDirectory = new File(LOG_DIR);
            if (!logDirectory.exists()) logDirectory.mkdirs();

            File logFile = new File(logDirectory, LOG_FILE);
            String logContent = String.format("%s | %s | %s: %s\n",
                    new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()),
                    getPriorityLabel(priority),
                    tag,
                    message);
            
            FileWriter writer = new FileWriter(logFile, true);
            writer.append(logContent);
            if (t != null) t.printStackTrace(new PrintWriter(writer));
            writer.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    private String getPriorityLabel(int priority) {
        return switch (priority) {
            case Log.VERBOSE -> "V";
            case Log.DEBUG -> "D";
            case Log.INFO -> "I";
            case Log.WARN -> "W";
            case Log.ERROR -> "E";
            case Log.ASSERT -> "A";
            default -> "UNKNOWN";
        };
    }
}

• 在Application类初始化：

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        Timber.plant(new Timber.DebugTree()); // 调试时输出到Logcat
        Timber.plant(new FileLoggingTree()); // 写入本地文件
    }
}

后续用Timber.d()、Timber.e()等方法输出的日志，都会自动保存到本地文件，崩溃后直接读取即可。

2. Logger（轻量级库） #

自带磁盘日志输出功能，配置简单：

• 添加依赖：

implementation 'com.orhanobut:logger:2.2.0'

• 初始化配置：

Logger.addLogAdapter(new DiskLogAdapter());

默认将日志保存到应用内部存储的logger目录，崩溃后可通过文件管理器访问该目录查看。

3. 自定义崩溃捕获+日志存储 #

如果需要完全自主控制，可结合Thread.UncaughtExceptionHandler捕获崩溃，同时将日志写入文件：

public class CrashHandler implements Thread.UncaughtExceptionHandler {
    private static final String LOG_PATH = "/sdcard/MyAppCrashLogs/";
    private Thread.UncaughtExceptionHandler defaultHandler;

    public CrashHandler() {
        defaultHandler = Thread.getDefaultUncaughtExceptionHandler();
    }

    @Override
    public void uncaughtException(@NonNull Thread thread, @NonNull Throwable throwable) {
        saveCrashLog(throwable);
        defaultHandler.uncaughtException(thread, throwable); // 交给系统处理崩溃
    }

    private void saveCrashLog(Throwable throwable) {
        try {
            File logDir = new File(LOG_PATH);
            if (!logDir.exists()) logDir.mkdirs();
            String fileName = "crash_" + System.currentTimeMillis() + ".txt";
            FileWriter writer = new FileWriter(LOG_PATH + fileName);
            writer.write(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()) + "\n");
            throwable.printStackTrace(new PrintWriter(writer));
            writer.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

在Application中注册：

@Override
public void onCreate() {
    super.onCreate();
    Thread.setDefaultUncaughtExceptionHandler(new CrashHandler());
}

三、注意事项 #

• Android 10及以上版本可使用应用专属存储，无需申请WRITE_EXTERNAL_STORAGE权限；低于10的版本需在Manifest中声明权限并动态申请。
• 建议定期清理旧日志文件，避免占用过多存储空间。

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