Android库模块异常崩溃时禁用方案咨询（AAR集成场景）

针对你的需求，我整理了几个实操性强的方案，既能隔离库内部的崩溃，又能在异常发生后自动禁用库，避免影响宿主App：

1. 局部异常捕获（包裹核心逻辑） #

最直接可控的方式，是把库中所有可能抛出异常的核心代码，用try-catch(Throwable t)包裹起来。这种方式不会干扰宿主App的异常处理链路，精准控制库内风险。

// 库内部的核心业务类
class MyLibraryCore {
    // 线程安全的状态标记：库是否可用
    private val isEnabled = AtomicBoolean(true)

    fun doLibraryWork() {
        if (!isEnabled.get()) {
            // 库已禁用，直接返回空实现，不执行任何逻辑
            return
        }
        try {
            // 这里写你的核心业务逻辑
            riskyOperation()
        } catch (t: Throwable) {
            // 捕获所有异常（包括Error类的崩溃，比如OOM、StackOverflow）
            Log.e("MyLibrary", "内部异常: ${t.message}", t)
            // 触发禁用逻辑
            disableLibrary()
        }
    }

    private fun disableLibrary() {
        isEnabled.set(false)
        // 清理库占用的资源：关闭数据库、注销回调、停止后台线程/协程等
        releaseAllResources()
    }

    private fun riskyOperation() {
        // 模拟可能崩溃的库内代码
        throw NullPointerException("模拟库内部空指针崩溃")
    }
}

2. 自定义异常处理器（隔离全局未捕获异常） #

如果库包含多线程、回调等分散的逻辑，可以自定义Thread.UncaughtExceptionHandler，只拦截处理来自库包名下的异常，同时保留宿主App的全局异常处理器。

class LibraryExceptionHandler(private val defaultHandler: Thread.UncaughtExceptionHandler?) : Thread.UncaughtExceptionHandler {
    // 你的库的包名前缀，用来识别异常是否来自库内部
    private val LIBRARY_PACKAGE_PREFIX = "com.your.library.package"

    override fun uncaughtException(t: Thread, e: Throwable) {
        // 检查异常栈是否属于库内部代码
        val isLibraryException = e.stackTrace.any { it.className.startsWith(LIBRARY_PACKAGE_PREFIX) }
        if (isLibraryException) {
            // 处理库内未捕获异常：记录日志 + 禁用库
            Log.e("MyLibrary", "未捕获异常，自动禁用库: ${e.message}", e)
            MyLibraryCore.getInstance().disableLibrary()
        } else {
            // 非库内异常，交给宿主App的默认处理器处理
            defaultHandler?.uncaughtException(t, e)
        }
    }

    // 在库初始化时调用，设置自定义异常处理器
    fun setup() {
        val defaultHandler = Thread.getDefaultUncaughtExceptionHandler()
        Thread.setDefaultUncaughtExceptionHandler(LibraryExceptionHandler(defaultHandler))
    }
}

3. 宿主侧安全封装（可选补充） #

如果允许宿主参与集成逻辑，可以让宿主在调用库的入口处额外包裹try-catch，作为双重保障——不过这种方式依赖宿主实现，可靠性不如库内部自行处理：

// 宿主App中调用库的代码示例
try {
    MyLibraryCore.getInstance().doLibraryWork()
} catch (t: Throwable) {
    Log.e("HostApp", "库调用异常", t)
    // 通知库自行禁用
    MyLibraryCore.getInstance().disableLibrary()
}

关键注意事项 #

• 捕获范围：优先捕获Throwable而非Exception，因为Error类的崩溃（比如OOM、栈溢出）也会导致App闪退，需要一并拦截。
• 资源清理：禁用库时一定要释放所有占用的资源（比如关闭IO流、注销广播接收器、停止后台任务），避免内存泄漏。
• 日志记录：异常发生后要详细记录日志（包括栈轨迹），方便后续排查问题，但不要将异常直接抛给宿主App。
• 线程安全：如果库涉及多线程操作，isEnabled状态建议用AtomicBoolean保证线程安全。

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