Android应用中Timber日志输出不一致问题排查（Kotlin）

以下是针对你遇到的Timber日志部分位置失效、但原生Log正常的问题，常见的排查方向和解决办法：

1. 初始化时机滞后 #

如果Timber的plant(Timber.DebugTree())操作不是在Application的onCreate方法最开始执行，而是延迟到其他逻辑之后，那么那些提前执行的代码（比如ViewModel的init块、NSD回调）可能在Timber初始化完成前就已经运行，导致日志无法输出。

解决办法：
确保Timber初始化放在Application onCreate的最前端，优先于其他业务逻辑：

class YourApp : Application() {
    override fun onCreate() {
        super.onCreate()
        // 优先初始化Timber
        if (BuildConfig.DEBUG) {
            Timber.plant(Timber.DebugTree())
        }
        // 其他应用初始化逻辑
    }
}

2. Logcat过滤规则不匹配 #

Timber.DebugTree默认使用调用类的类名作为日志标签，而你使用原生Log时指定了自定义标签（如nsdhelper、mainviewmodel）。如果Logcat设置了标签过滤或级别过滤，可能会漏掉Timber的日志。

解决办法：

• 检查Logcat的过滤条件，暂时清空标签过滤，或添加Timber对应的类名标签（比如NSD回调所在类的类名）
• 确认Logcat的日志级别设置为Error及以上（因为你调用的是Timber.e）

3. 多进程场景下未初始化Timber #

如果应用使用了多进程（比如NSD服务在后台进程运行），而你只在主进程初始化了Timber，那么其他进程中的Timber调用会因为没有plant Tree而失效。

解决办法：
在Application的onCreate中，针对所有需要输出日志的进程初始化Timber：

class YourApp : Application() {
    override fun onCreate() {
        super.onCreate()
        if (BuildConfig.DEBUG) {
            val currentProcessName = getCurrentProcessName()
            // 主进程或目标进程才初始化Timber
            if (currentProcessName == packageName || currentProcessName == "com.your.app.target_process") {
                Timber.plant(Timber.DebugTree())
            }
        }
    }

    private fun getCurrentProcessName(): String {
        val pid = android.os.Process.myPid()
        val manager = getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
        for (process in manager.runningAppProcesses) {
            if (process.pid == pid) {
                return process.processName
            }
        }
        return ""
    }
}

4. 自定义Tree的过滤逻辑干扰 #

如果除了DebugTree，你还plant了自定义Tree，或者重写了DebugTree的isLoggable、log、createStackElementTag方法，可能导致日志被过滤或标签不匹配。

解决办法：

• 检查是否有额外的Timber.plant调用，移除不必要的自定义Tree
• 如果需要自定义Tree，确保没有过滤掉ERROR级别的日志，且标签逻辑符合预期：

// 示例：确保ERROR级别日志允许输出
class CustomTree : Timber.DebugTree() {
    override fun isLoggable(tag: String?, priority: Int): Boolean {
        return priority >= Log.ERROR
    }
}

5. Debug模式下的混淆问题 #

部分项目可能在Debug模式下开启了混淆（minifyEnabled=true），导致Timber的方法被混淆或移除，引发部分调用失效。

解决办法：

• 在build.gradle的Debug配置中关闭混淆：

android {
    buildTypes {
        debug {
            minifyEnabled false
            // 其他配置
        }
    }
}

• 如果必须开启Debug混淆，在proguard-rules.pro中添加Timber的保留规则：

-keep class timber.log.Timber** { *; }
-keepnames class timber.log.Timber$*

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