Глобальный логгер: ReplaceGlobals

В пакете zap живут две глобальные переменные: L для zap.Logger и S для zap.SugaredLogger. До первого вызова ReplaceGlobals обе указывают на заглушки: записи уходят в никуда, Sync возвращает nil, паники нет — код работает и молчит. zap.ReplaceGlobals(logger) меняет обе переменные разом и возвращает функцию restore, которая восстанавливает прежние значения. Подмена безопасна для читателей: внутри глобала мьютекс, data race не возникнет — опасность в другом, в порядке вызовов, и об этом ниже. Читать глобал дёшево: zap.L() снимает блокировку на чтение и отдаёт текущее значение. Полезно понимать механику: zap.L() каждый раз возвращает актуального логгера, а вот переменная, в которую вы скопировали zap.L() однажды, остаётся старым логгером навсегда — на этом копировании спотыкаются чаще, чем на самой подмене.

Случай первый — утилита в main-пакете: пять файлов, два флага, DI-цепочка длиной в одну функцию; глобал здесь дешевле контекста, и это нормально. Случай второй — граница с чужим кодом: библиотека пишет через zap.L(), и её сигнатуры вы поменять не можете; тогда пара zap ReplaceGlobals и zap.L() — единственный шов, куда записи библиотеки вообще попадут. Случай третий — аварийные пути, до которых контекст не доезжает: хендлер паники в горутине, обработчик сигналов, финализатор процесса. Во всех трёх глобал — запасной выход, а не архитектура. Признак здорового отношения к глобалу: основной поток приложения передаёт логгер явно — конструкторам, структурам, контексту, — а zap.L() остаётся страховкой, на которую смотрят при разборе падений.

Опасность глобала — не data race: подмена защищена мьютексом, и race detector ругаться не будет. Опасность — в порядке вызовов. init-функции пакетов выполняются до main, и если библиотека пишет в zap.L() из init, на тот момент глобал ещё заглушка. Если ReplaceGlobals зовут в init другого пакета, порядок определяет граф импортов — нечитаемая зависимость, которая меняется от одной перестановки импорта в файле. Горутины, стартовавшие до подмены — фоновая очистка, прогрев кеша, запущенный из инициализатора, — тоже пишут в заглушку, и их записи теряются без следа. Диагноз ставится по одному симптому: записи есть у одних пакетов и нет у других, а перезапуск не меняет ничего. Лечение всегда одно: глобал настраивается в main до запуска горутин, а не в глубине импортов.

Глобал — состояние всего процесса, и тесты делят его между собой. Заменили глобал в одном тесте и не вернули — следующий тест пишет в чужого наблюдателя или молчит. С t.Parallel() картина грустнее: параллельные тесты дерутся за один глобал, и результат зависит от планировщика, то есть флакает. Дисциплина простая: zap.ReplaceGlobals возвращает restore, и defer restore() — обязательная пара к каждому вызову в тесте; а параллельный тест, которому нужен глобал, — повод переписать его на явную передачу логгера, как делает observer из урока про тестирование логов. Прогон таких тестов — обычный go test на локальном Go, никакой обвязки не нужно.

Второй вызов не запрещён и не паникует: он подменяет текущее значение и возвращает restore, возвращающий уже его. Пары вызовов складываются в стек, откаты применяются в обратном порядке — это удобно в CLI с подкомандами: корень настроил глобал, подкоманда подменила логгера своим Named-потомком и вернула всё defer'ом. Две подмены без отката — уже запах дизайна: второй restore вернёт первого логгера, а не заглушку, и цепочка подмен растёт с каждым пакетом, решившим «подстроить глобал под себя». Правило из чек-листа ниже — один вызов на процесс — существует именно потому, что механика позволяет больше.

Здоровый проект выглядит так: main собирает конфиг и логгер — пресет или Build из урока про конфиг, — затем делает ReplaceGlobals один раз и дальше передаёт логгера по рукам: конструкторам сервера, репозиториев, посредников. Дети строятся через With и Named; иерархию имён разбирает урок про With и Named. Глобал при такой схеме остаётся для трёх случаев из начала урока. В тестах же логгер вообще не глобален: код под тест принимает *zap.Logger, и наблюдатель входит через конструктор. Спорное мнение в защиту глобала: в маленьких CLI он экономит больше, чем стоит, — я не люблю глобальные состояния, но жертвовать архитектурой ради пятисот строк утилиты не готов, и zap.L() с ReplaceGlobals в main — разумный компромисс с условием: как только файл растёт, зависимость уходит в конструкторы.

restore — это func() без аргументов и результата: она возвращает те глобальные значения, которые были до подмены, включая заглушку, если глобал ещё не настраивали. Подмена идёт парами — L и S меняются одновременно, рассинхрона не бывает. Если цель была не в подмене логгера, а в смене уровня, глобал трогать не нужно: атомарный уровень из урока про динамические уровни меняет порог на живом процессе без перевязки зависимостей. Подмена нужна там, где меняется само ядро: тест ставит наблюдателя, CI-скрипт перевключает файловый вывод. Правило разделения: уровень — через AtomicLevel, ядро — через ReplaceGlobals, и путать их не стоит.

Соседняя проблема — код, который не должен зависеть даже от факта наличия zap, — решается интерфейсом: мост logr и zapr разбирается в следующем уроке, и там подмена в тестах становится ещё проще. Дисциплина тестов глобала опирается на observer из урока про zaptest и observer. Карта всего курса — на странице курса zap; дальше по плану — эксплуатация и итоговый проект, где глобал, наконец, заменяется явной передачей.