Go atomic.Value Swap 怎样拿到替换前的值

我第一次用 atomic.Value 替换配置快照时，想在更新后顺手拿到旧配置做清理，结果把 Load 和 Swap 混在了一起。真正适合这个任务的写法是：Swap(newValue) 把新值写入容器，同时返回替换前的值；如果容器还是零值，返回值是 nil。

官方地址：https://pkg.go.dev/sync/atomic#Value.Swap

先记住三个边界：传给 Swap 的新值不能是 nil；同一个 Value 的多次 Swap 必须使用同一具体类型；首次替换没有旧值，所以返回 nil。

先判断 Swap 返回的是什么

排查时我会先看调用者到底需要什么。如果只是读当前配置，用 Load；如果要把新配置放进去，并在同一个原子替换点拿到旧配置，就用 Swap。官方实现把这两个动作绑定在同一个方法语义里，返回值的具体类型仍然是 any。

让新旧值保持同一具体类型

atomic.Value 不是一个可以随意混装类型的盒子。第一次成功写入会确定具体类型，之后的 Swap 也要使用同一种具体类型；把 *Config 换成 Config，或者把一个结构体换成另一种结构体，都会触发 panic。nil 也不能直接作为新值传入。

package main

import (
    "fmt"
    "sync/atomic"
)

type Config struct {
    Endpoint string
}

func replaceConfig(value *atomic.Value, next *Config) *Config {
    // 统一使用 *Config，避免首次写入后发生具体类型不一致。
    old := value.Swap(next)
    if old == nil {
        // 零值 Value 没有旧快照，首次替换时正常返回 nil。
        return nil
    }
    // 这里的断言与上面的统一类型约定相匹配。
    return old.(*Config)
}

func main() {
    var value atomic.Value
    previous := replaceConfig(&value, &Config{Endpoint: "/v1"})
    fmt.Println(previous == nil) // 首次替换没有旧值。
    previous = replaceConfig(&value, &Config{Endpoint: "/v2"})
    fmt.Println(previous.Endpoint) // 第二次替换拿到 /v1。
}

这里不要把“返回 nil”理解为 Swap 失败：它只表示容器在这次替换前为空。真正需要避免的是传入 nil，那会直接触发 sync/atomic 的 panic。

用旧值完成配置交接

在配置热更新里，旧值通常有两个用途：记录旧版本，或者在它持有额外资源时安排清理。我的经验是让 Swap 只负责原子交接，把资源释放放在交接之后的普通逻辑里；不要把复杂清理塞进读路径，也不要假设返回的旧指针还能代表当前配置。

type Snapshot struct {
    Version int
    Endpoint string
}

func publish(value *atomic.Value, next *Snapshot) {
    // Swap 负责一次原子替换，并把旧快照交给当前调用方。
    old := value.Swap(next)
    if old == nil {
        // 首次发布没有旧对象，不执行旧资源清理。
        return
    }
    oldSnapshot, ok := old.(*Snapshot)
    if !ok {
        // 类型不符合约定时立即暴露错误，避免静默使用错误数据。
        panic("配置快照类型不一致")
    }
    // 这里只记录交接结果；真实资源清理由明确的生命周期函数负责。
    _ = oldSnapshot.Version
}

如果旧快照包含连接、文件或缓存句柄，清理时还要确认没有其他读者仍在使用它。Swap 只提供原子替换和旧值返回，不会替你管理对象生命周期。

并发调用时别把旧值当成锁

多个 goroutine 同时调用 Swap 时，每个调用都会获得某个被替换下来的值，但调用者不能据此推断自己拿到的是“最后一个旧值”，也不能用返回值构造业务锁。需要条件更新时，应考虑 CompareAndSwap；只需要无条件发布新快照时，Swap 更直接。

常见问题

第一次调用 Swap 为什么拿到 nil？ 因为 Value 的零值还没有旧内容；这不是替换失败。

能不能用 nil 清空 atomic.Value？ 不能。Swap 的新值不能是 nil；需要表达“没有配置”时，可用一个统一具体类型的状态对象表示。

Swap 返回旧值后能马上释放吗？ 只有在确认没有其他读者继续使用旧对象时才能释放。原子替换不等于引用计数或生命周期管理。

什么时候改用 CompareAndSwap？ 当更新必须基于某个旧版本或旧指针仍然有效时，用 CompareAndSwap 表达条件；无条件发布则继续用 Swap。