Go Badger 怎么给嵌入式键值数据设置过期时间

如果嵌入式 Badger 里保存的是缓存、验证码或临时计算结果，通常不应该让调用方自己记住删除时间。更直接的做法是创建 badger.Entry 后调用 WithTTL(time.Duration)，再通过 Txn.SetEntry 写入。TTL 到期后，这个键不会再被正常读取；但对应磁盘空间还要等 Badger 的垃圾回收过程处理。

官方地址：https://github.com/dgraph-io/badger

设置过期时间的最小写法是 badger.NewEntry(key, value).WithTTL(ttl) 配合 txn.SetEntry(entry)。TTL 控制的是数据何时失效，不是“到点立刻删除文件中的字节”。

先分清 TTL 到期和磁盘回收

Badger 的 Entry 会记录一个过期时间。读取路径遇到已经过期的记录时，会把它视为不可用，因此业务层可以把它当成缓存未命中或临时数据不存在。官方快速入门同时强调，过期后占用的磁盘空间不会在同一时刻自动变成可用空间，后续仍需要垃圾回收清理。

用 WithTTL 写入一条带过期时间的记录

WithTTL 接受 time.Duration，例如 30*time.Minute。它返回同一个 Entry，因此可以直接接在 NewEntry 后面，再交给当前更新事务的 SetEntry。

package main

import (
    "errors"
    "fmt"
    "time"

    badger "github.com/dgraph-io/badger/v4"
)

// putWithTTL 把临时值和有效时长绑定，避免调用方忘记设置过期时间。
func putWithTTL(db *badger.DB, key, value []byte, ttl time.Duration) error {
    // 小于等于零的时长通常意味着配置错误，先在业务边界拒绝。
    if ttl 

这里的关键不是把删除任务放到定时器里，而是让过期时间成为写入记录的一部分。若 TTL 来自配置，建议在调用前拒绝零值和负值，避免把错误配置写成已经过期的数据。

读取时按普通 Get 处理过期结果

TTL 不需要单独的读取 API。仍然使用事务的 Get，然后按业务把“键不存在”和“已经过期”归入缓存未命中路径即可。不要把内存中的过期时间当作唯一判断依据，因为真正的生命周期应该由 Badger 记录负责。

// readTemporaryValue 读取临时值，找不到时交给调用方回源。
func readTemporaryValue(db *badger.DB, key []byte) ([]byte, error) {
    var value []byte
    err := db.View(func(txn *badger.Txn) error {
        item, err := txn.Get(key)
        if err != nil {
            // ErrKeyNotFound 覆盖了不存在或已不可读的业务结果。
            return err
        }
        // ValueCopy 把值复制出事务范围，避免返回失效的内部切片。
        value, err = item.ValueCopy(nil)
        return err
    })
    if errors.Is(err, badger.ErrKeyNotFound) {
        return nil, nil
    }
    if err != nil {
        return nil, fmt.Errorf("read temporary value: %w", err)
    }
    return value, nil
}

如果业务需要续期，通常重新构造 Entry 并再次 SetEntry，让新的 TTL 从这次写入开始计算。不要只更新一个旁路的时间表，却继续复用原来的 Badger Entry。

上线时处理三个容易混淆的边界

过期不等于立刻瘦身

一条记录已经不能被读取，并不代表 Badger 目录会马上变小。容量告警应观察垃圾回收、压缩和写入增长等整体指标，不能用“刚过期几条键”作为磁盘已经释放的证据。

TTL 是写入语义，不是定时删除回调

如果过期后还要触发通知、补偿或统计，不能把这些动作寄托在 WithTTL 上。应另建可重试的任务或事件记录，并让它拥有独立的幂等键。

读不到时先判断业务是否允许回源

缓存可以在 ErrKeyNotFound 后回源重建；一次性令牌则可能应该直接返回失效错误。TTL 只告诉存储层这条记录不可再读，具体的用户提示和恢复策略仍由业务决定。

结论与速查

Go Badger 设置键值过期时间时，使用 NewEntry(...).WithTTL(ttl) 创建带生命周期的 Entry，再在 Update 事务里调用 SetEntry。读取继续走普通 Get，把不可读结果接入业务的未命中或失效分支；容量治理则单独关注垃圾回收，而不是把 TTL 当成立即删除。

相关问题

• Badger 的 TTL 应该传什么类型？答：传 time.Duration，例如 10*time.Minute。
• 过期后还能用 Get 读到吗？答：正常读取路径会把过期项视为不可用，业务侧应按未命中或失效处理。
• 设置 TTL 后目录会立刻变小吗？答：不会，过期可读性和后续垃圾回收是两个阶段。