sync.Once

Ленивая инициализация

var (
    once     sync.Once
    s3Client *S3Client
)

func GetS3Client() *S3Client {
    once.Do(func() {
        s3Client = newS3Client()
    })
    return s3Client
}

Do выполняет функцию один раз. Первый вызвавший запускает newS3Client, остальные, пришедшие во время выполнения, блокируются и после возврата Do видят готовый s3Client. Это каноническая ленивая инициализация — без проверок «а не инициализировали ли уже».

Паника «засчитывается»

once.Do(func() {
    panic("инициализация упала")
})
once.Do(func() {
    fmt.Println("не выполнится")
})

Если функция внутри Do паникует, Once считает вызов выполненным: повторный Do ничего не запустит. Для инициализации это значит: упала — навсегда. Если нужна возможность «попробовать ещё раз», Once не подходит.

Где Once уместен

Одноразовая инициализация: создание S3-клиента, пула соединений, регистрация обработчиков. Везде, где «сделать один раз» важнее, чем «сделать при старте». Отличие от init: Once — лениво, в момент первого обращения, а не при загрузке пакета.