原生移动开发 / 系统课时

定位数据库慢查询与写阻塞

定位数据库慢查询与写阻塞

当 Android 应用出现列表加载慢、页面卡顿或保存操作明显延迟时,数据库常是关键瓶颈。本课从查询耗时、索引和事务范围三个方向建立定位顺序,并用 Room 的实际代码验证如何避免数据库工作占用关键线程。

学习目标

  • 能区分慢查询、锁等待与事务范围过大的表现
  • 能用执行计划和耗时日志判断索引是否真正生效
  • 能把数据库操作移出主线程,并缩小写事务的锁定范围

先区分慢查询和写阻塞

慢查询通常表现为某条 SQL 本身执行时间较长,例如过滤、排序或连接缺少合适索引。写阻塞则更像“大家都在等一个事务”,某个写事务持有锁的时间过长,会让其他查询或写操作等待。

排查时先记录 SQL 的实际耗时,再观察是否存在长事务。不要只看到一次请求慢,就直接给表增加索引;错误索引、低选择性索引或数据量尚小时看不出收益,都可能让判断失真。

用 Room 记录查询耗时

下面是一个可运行的 Kotlin 片段,使用 Room Database 内置的查询回调记录执行过的 SQL,并通过 suspend DAO 保证调用方可以在协程中执行数据库操作。

kotlin
import android.content.Context
import android.util.Log
import androidx.room.Dao
import androidx.room.Database
import androidx.room.Entity
import androidx.room.Room
import androidx.room.RoomDatabase
import androidx.room.Query

@Entity(tableName = "orders")
data class Order(
    val id: Long,
    val userId: Long,
    val status: String,
    val createdAt: Long
)

@Dao
interface OrderDao {
    @Query("SELECT * FROM orders WHERE userId = :userId AND status = :status ORDER BY createdAt DESC")
    suspend fun findRecent(userId: Long, status: String): List<Order>
}

@Database(entities = [Order::class], version = 1, exportSchema = false)
abstract class AppDatabase : RoomDatabase() {
    abstract fun orderDao(): OrderDao
}

fun buildDatabase(context: Context): AppDatabase {
    return Room.databaseBuilder(context, AppDatabase::class.java, "app.db")
        .setQueryCallback({ sqlQuery, bindArgs ->
            Log.d("RoomSQL", "sql=$sqlQuery args=$bindArgs")
        }, { command ->
            Log.d("RoomSQL", "executor=$command")
        })
        .build()
}

预期结果

text
日志中可以看到 Room 实际执行的 SQL 与绑定参数,例如:
sql=SELECT * FROM orders WHERE userId = ? AND status = ? ORDER BY createdAt DESC args=[42, PAID]

这个回调适合开发和排查阶段观察 SQL;真正判断瓶颈时,还要结合 Android 性能分析工具或 SQLite 执行计划,而不能只依据日志时间戳下结论。

检查索引是否匹配查询

对于同时按 userId 和 status 过滤、再按 createdAt 排序的查询,复合索引通常比只给单列分别建索引更值得检查。可以直接在 SQLite 中查看执行计划:

sql
EXPLAIN QUERY PLAN
SELECT *
FROM orders
WHERE userId = 42 AND status = 'PAID'
ORDER BY createdAt DESC;

预期结果

text
QUERY PLAN
SEARCH orders USING INDEX ...

实际输出会因 SQLite 版本、表结构和已有索引而不同。关键不是索引名称是否固定,而是执行计划是否显示正在利用合适的索引;若仍然需要扫描大量行,应继续检查索引列顺序、过滤条件与排序需求。

缩短事务持锁时间

写阻塞经常来自“事务里做了太多事”。例如读取网络结果、计算复杂数据或处理文件后才提交数据库,都会无谓延长事务持续时间。事务应尽量只包住必须保持原子性的数据库操作。

可以把逻辑拆成“准备数据”和“提交数据”两段:准备阶段不持有数据库事务,真正写入时再进入短事务。对于 Room,写操作也应通过 suspend DAO 或合适的后台执行上下文完成,避免主线程等待锁释放。

定位时的验证顺序

先确认慢的是哪条 SQL,再确认是扫描、排序还是锁等待,最后检查这条 SQL 是否运行在主线程。一个常见有效路径是:记录 SQL → 查看执行计划 → 测量事务持续时间 → 检查线程 → 调整索引或事务边界 → 重新压测验证。

数据库优化的目标不是让每条 SQL 都拥有最多索引,而是让关键查询读取更少的数据、让关键写事务尽快结束,并确保数据库工作不会阻塞 UI 线程。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位数据库慢查询与写阻塞

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通