Go 问答：sync.Map.LoadAndDelete 的 loaded 返回值如何区分键不存在

清理并发缓存时，最容易误判的一行代码是 if value == nil。sync.Map.LoadAndDelete 返回的第一个值确实可能是 nil，但它不能单独说明键不存在；真正的判断位是第二个返回值 loaded。

判断键是否存在只看 loaded：loaded=true 表示这次确实取到了并删除了键，即使 value 是 nil；loaded=false 才表示删除前没有这个键。

LoadAndDelete 到底返回了什么

官方 sync.Map 文档把这个方法定义为：删除指定键，并返回删除前保存的值；loaded 报告这个键是否存在。它和先调用 Load、再调用 Delete 不一样，后者在两个调用之间会留下并发窗口。

把返回值写成下面这样更容易读懂：

value, loaded := cache.LoadAndDelete(key)
if !loaded {
    // 删除前没有 key
    return
}
// key 已经被这次调用取出并删除，value 是旧值
use(value)

这里的 loaded 是存在性结论，不是“value 是否非空”的结论。图片中的调用链把一次调用、返回判断和删除后的状态放在同一条路径上。

nil 值为什么不能拿来判断键不存在

sync.Map 的键和值类型都是 any，因此可以把一个键关联到 nil。下面的例子专门把“存在但值为 nil”和“根本不存在”放在一起比较：

package main

import (
    "fmt"
    "sync"
)

func main() {
    var cache sync.Map
    cache.Store("empty", nil)

    value, loaded := cache.LoadAndDelete("empty")
    fmt.Printf("empty: value=%v loaded=%v\n", value, loaded)

    value, loaded = cache.LoadAndDelete("missing")
    fmt.Printf("missing: value=%v loaded=%v\n", value, loaded)
}

第一行输出中的 value 是 ，但 loaded=true：这说明键存在过，并且已经被本次调用删除。第二次调用得到 value=、loaded=false，两种情况的第一个返回值相同，只有第二个返回值不同。

并发清理时应保留哪个判断边界

如果多个 goroutine 都在抢着消费同一个键，只有拿到 loaded=true 的调用者才应继续处理旧值。其他调用者拿到 loaded=false，应直接结束，不要把“没有拿到值”当成一次需要重试的业务错误。

还要注意，LoadAndDelete 只保证 map 内部这次取出和删除的并发语义。它不会自动回滚数据库、关闭文件或扣减业务计数。如果取出的值代表外部资源，建议让消费动作带有唯一标识，并在失败重试时检查幂等状态。

if value, loaded := cache.LoadAndDelete(jobID); loaded {
    // 只有一个竞争者进入这里
    handle(value)
}

常见问题

LoadAndDelete 返回 nil,true 是什么意思？

表示键存在，旧值恰好是 nil，并且这次调用已经把键删除。判断存在性要看 true。

可以先 Load 再 Delete 吗？

如果需要“取出并只处理一次”的语义，不建议拆成两个调用；并发 goroutine 可能在中间同时读到同一个值。

loaded=false 时 value 一定是 nil 吗？

标准实现返回的未加载值是 nil，但业务代码仍应把 loaded 作为存在性依据，而不是用 value 的内容猜测。

小结

sync.Map.LoadAndDelete 的两个返回值职责不同：value 负责携带旧值，loaded 负责报告键是否存在。尤其在值允许为 nil、或多个 goroutine 同时清理时，把这两个含义分开，才能避免漏处理和重复处理。