原生移动开发 / 系统课时
Logcat、断点与问题定位
Logcat、断点与问题定位
这节课用一个可重复触发的崩溃串起完整调试链路:先在 Logcat 中确认现象,再用断点和变量监视验证假设,最后从异常堆栈定位到业务代码。完成后,你应能把“应用崩了”收敛成具体输入、具体语句和可验证的修复。
学习目标
- 使用 Logcat 按进程、级别和关键字缩小日志范围。
- 在断点处检查局部变量、表达式和调用栈,验证问题假设。
- 从异常类型和首个业务栈帧定位根因,并完成修复后的回归验证。
先建立可重复的问题
调试最怕“偶尔出现”。下面的 Activity 在点击按钮后把字符串 42x 转成整数,必然触发 NumberFormatException。示例使用系统 Activity 和代码创建按钮,便于直接放进一个最小 Android 工程中验证。
package com.example.debugdemo
import android.app.Activity
import android.os.Bundle
import android.util.Log
import android.widget.Button
class MainActivity : Activity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val button = Button(this).apply { text = "触发问题" }
setContentView(button)
button.setOnClickListener {
val raw = "42x"
Log.d("DebugDemo", "raw=$raw")
// 这里是预期的故障点:非法数字文本会抛出异常。
val value = raw.toInt()
Log.d("DebugDemo", "value=$value")
}
}
}预期输出
D/DebugDemo: raw=42x
E/AndroidRuntime: FATAL EXCEPTION: main
E/AndroidRuntime: java.lang.NumberFormatException: For input string: "42x"
E/AndroidRuntime: at com.example.debugdemo.MainActivity.<METHOD>(<PATH>:<LINE>)实际日志会包含 <TIME>、<PID>、完整类名和更多系统栈帧,行号也会随代码变化。关键是同时看到自定义日志、异常类型和指向应用代码的栈帧。
用 Logcat 先把范围缩小
打开应用对应进程的 Logcat,只保留当前应用和 Error、Debug 等必要级别,再搜索 DebugDemo 或异常名。先确认“哪个操作之后出现异常”,再观察异常之前最后一条业务日志,通常能快速确定故障发生在哪个阶段。
不要一开始就阅读数百行系统日志。对于崩溃,优先找 FATAL EXCEPTION、异常类型和 Caused by;对于逻辑错误,则比较关键状态值和执行顺序。日志只负责给出线索,不应替代断点验证。
在断点处验证假设
在 val value = raw.toInt() 这一行设置断点,用 Debug 模式启动应用并点击按钮。程序暂停后先看 raw,此时应为 42x;再在表达式求值或 Watches 中检查 raw.toIntOrNull(),结果应为 null,这直接证明输入不满足整数格式。
如果问题来自更深层的方法,不要只盯当前行。沿调用栈向上查看“谁传入了这个值”,直到找到数据第一次偏离预期的位置。单步执行适合确认控制流,变量监视适合确认状态,调用栈适合确认责任边界,三者用途不同。
从异常堆栈定位业务代码
读堆栈时先看异常类型和消息,再从上到下寻找第一个属于自己包名的栈帧。系统库栈帧说明异常经过了哪些框架代码,但通常不是你要修改的位置;首个业务栈帧则指出了最接近根因的源码行。
本例可把强制转换改为 raw.toIntOrNull(),并在结果为空时给用户提示或回退处理。修复后再次执行同样点击路径,Logcat 不再出现 AndroidRuntime 的致命异常,断点处也能看到异常输入被分支处理,才算完成闭环。