Библиотека spf13/viper долгое время считалась стандартом конфигурации в Go, однако в микросервисах она нередко порождает проблемы: глобальное состояние, раздутые зависимости и доступ к параметрам по нетипизированным строковым ключам вроде viper.GetString("port").
Надежная альтернатива — переход к плоским типизированным структурам с явной валидацией на границе приложения. Пошаговый процесс миграции:
- Описание схемы: в пакете config создается структура Config с yaml-тегами полей.
- Потоковое чтение: файл настроек открывается и считывается через вызов yaml.NewDecoder(file).Decode(&cfg).
- Изоляция секретов: токены и пароли считываются отдельно из переменных окружения через os.LookupEnv, предотвращая попадание секретов в репозиторий.
- Валидация: вызывается метод cfg.Validate() с проверкой обязательных параметров, после чего Config передается в точку сборки (composition root) в main.go.
Для проверки работы пишутся юнит-тесты на валидный YAML, реакцию на неизвестные поля и запуск с пустым обязательным окружением. Исходный код и документация библиотеки доступны в репозитории Viper.
