Go Once.Do 内部 panic 后下一次调用还会执行吗

会，但要分清“调用还会返回”和“初始化函数还会执行”。如果 sync.Once.Do 传入的函数发生 panic，第一次调用会把 panic 继续向外抛出；对同一个 Once 再调用时，初始化函数不会重新执行，调用会直接返回。也就是说，Once 记录的是“一次动作已经被处理”，不是“初始化一定成功”。

panic 后第二次 Do 为什么不再进入初始化函数

Once.Do 的契约是：对一个 Once 实例，传入函数只执行一次。官方文档特别说明，函数如果 panic，Do 仍把它视为已经返回，因此后续调用会跳过函数体。这个设计避免了并发调用者在初始化失败后再次进入一个可能只完成了一半的共享状态。

所以，下面两个结果并不矛盾：第一次 Do 让程序看到 panic；第二次 Do 却什么也不做。panic 是第一次调用的返回表现，Once 的完成标记是实例级状态。

用调用计数和 recover 验证真实边界

排查这类问题时，不要只看日志里有没有第二次 panic。更可靠的信号是给初始化函数加一个执行计数，并在每次外层调用中单独 recover：

package main

import (
    "fmt"
    "sync"
)

func main() {
    var once sync.Once
    runs := 0

    initFn := func() {
        runs++ // 只用于观察初始化函数实际进入了几次
        panic("配置加载失败")
    }

    call := func(label string) {
        defer func() {
            if err := recover(); err != nil {
                fmt.Println(label, "捕获:", err)
            }
        }()
        once.Do(initFn) // 第一次会触发 panic，后续调用会跳过 initFn
        fmt.Println(label, "正常返回")
    }

    call("第一次")
    call("第二次")
    fmt.Println("执行次数:", runs)
}

预期观察点是：第一次调用打印捕获信息，第二次调用打印“正常返回”，最后的执行次数仍为 1。这里的“正常返回”只说明第二次 Do 没有再次触发 panic，不代表配置已经加载成功；业务代码仍应检查配置对象是否可用。

需要重试时，不要把同一个 Once 当成重试器

如果初始化失败后允许重试，常见做法是把“只执行一次”和“失败可恢复”拆开。最简单的是在确定旧状态不再被使用时创建新的 sync.Once；并发服务中更稳妥的做法是用互斥锁保护显式状态，例如 uninitialized、initializing、ready、failed，并记录失败原因和下一次重试条件。

如果需求只是让所有调用者看到一致的 panic，可以使用 Go 1.21 引入的 sync.OnceFunc 或 sync.OnceValue。它们会缓存 panic 值，在后续调用中再次 panic 同一个值；这与 Once.Do 的“后续调用静默跳过”表现不同，但依然不会重新执行函数体。

上线前检查这三个误区

• 不要因为 recover 成功就把共享对象当成已初始化；先检查对象和错误状态。
• 不要复制已经使用过的 sync.Once，官方文档要求 Once 首次使用后不能复制。
• 不要在 Do 内部再次调用同一个 Once；这会形成死锁，而不是获得一次新的初始化机会。

常见问题

recover 后再次调用 Do 会重新执行吗？

不会。recover 只处理 panic 的传播，不能清除 Once 的完成状态。

OnceFunc 会在第二次调用时重新跑函数吗？

不会。它只会再次 panic 同一个值，函数体仍只执行一次。

想重试初始化应该怎么做？

把重试策略建模为显式状态，并在安全边界创建新的 Once 或由锁保护状态迁移；不要修改或复制已经使用过的 Once。