Android开发中如何为Room数据库记录设置TTL过期时间

完全可以基于Room原生能力实现TTL缓存机制，不需要引入额外第三方库，整套逻辑和你设计的流程完全匹配，具体实现步骤如下：

1. 改造缓存表结构 #

给缓存实体增加时间戳字段，同时用唯一缓存键区分不同接口的缓存数据：

@Entity(tableName = "api_cache")
data class ApiCache(
    @PrimaryKey val cacheKey: String, // 唯一缓存键：一般由请求URL+排序后的请求参数/请求体哈希生成
    val responseContent: String, // 存储序列化后的接口返回数据
    val createTimestamp: Long // 缓存写入时的本地时间戳，取System.currentTimeMillis()
)

2. DAO层直接内置过期判断逻辑 #

直接在SQL查询层面过滤过期数据，不需要业务层额外做判断，查询效率更高。以30分钟（对应毫秒值1800000）TTL为例：

@Dao
interface ApiCacheDao {
    // 仅查询未过期的有效缓存
    @Query("SELECT * FROM api_cache WHERE cacheKey = :key AND (:currentTime - createTimestamp) < :ttl LIMIT 1")
    suspend fun queryValidCache(
        key: String,
        currentTime: Long = System.currentTimeMillis(),
        ttl: Long = 1800000L
    ): ApiCache?

    // 写入/刷新缓存，同key数据直接覆盖
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insertCache(cache: ApiCache)

    // 异步清理过期缓存，避免数据库冗余
    @Query("DELETE FROM api_cache WHERE (:currentTime - createTimestamp) >= :ttl")
    suspend fun clearExpired(
        currentTime: Long = System.currentTimeMillis(),
        ttl: Long = 1800000L
    )
}

3. 业务层逻辑对齐设计流程 #

• 发起请求时先调用queryValidCache查本地，返回非空直接解析数据展示，不需要走网络
• 如果查询结果为空（不存在对应缓存/缓存已过期），直接调用接口拉取最新数据
• 接口请求成功后，将返回结果序列化，生成对应cacheKey，传入当前时间戳构造ApiCache对象，调用insertCache写入本地完成缓存刷新
• 可以在APP启动、缓存写入等时机异步调用clearExpired清理过期数据，避免存储体积无限增长

可选优化点 #

• 如果不同接口需要配置不同TTL，可以给ApiCache实体增加ttlMillis字段，写入缓存时传入当前接口的TTL值，查询时直接用条目自带的TTL做判断即可，灵活度更高
• 时间戳统一使用本地设备时间即可，不要用服务端返回时间，避免用户修改时区、本地与服务端时间差导致的TTL判断异常
• 大尺寸返回内容可以考虑做序列化压缩后再存储，降低数据库占用

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