«Пакет
cryptotestпредоставляет детерминированный источник случайности для тестирования».
Этой строчкой авторы Go открывают документацию testing/cryptotest, появившегося в Go 1.27. Стоит коду обратиться к генератору crypto/rand, и каждый прогон тестов получает свежую системную энтропию: упавший в CI тест локально проходит чисто. Так как же отладить и воспроизвести такой сбой?
Почему тесты с crypto/rand не поддавались отладке
Простая мысль — подменить источник случайности своим io.Reader с заранее заданными байтами. Но в современных версиях crypto/rsa и crypto/ecdsa стандартная библиотека всё жёстче требует системной энтропии и попросту игнорирует пользовательские ридеры.
Даже с заглушкой внутри твоего кода криптоалгоритмы всё равно пойдут за случайностью к ОС. Редкий граничный сбой в генерации ключей или токенов превращается в призрак, который невозможно поймать повторным запуском.
Как SetGlobalRandom фиксирует и сбрасывает поток энтропии
В Go 1.27.3 эту проблему решает функция SetGlobalRandom из testing/cryptotest:
func SetGlobalRandom(t *testing.T, seed uint64)
Значение seed переводит глобальный источник энтропии процесса в детерминированный режим — это затрагивает и прямые вызовы crypto/rand.Read, и все скрытые источники в пакетах crypto/.... Аргумент t *testing.T ограничивает подмену временем жизни теста: после завершения рантайм сам вернёт системный генератор.
Логичный вопрос: а что если внутри одного теста нужно прогнать генерацию дважды и сверить результаты? Повторный вызов SetGlobalRandom с тем же сидом сбрасывает поток в исходное состояние.
Я обратил внимание на рабочий пример random_test.go из канала Библиотека Go-разработчика, проверенный на Go 1.27.3. Тест фиксирует сид 42, читает 16 байт — типичный размер для токена сброса пароля или проверки JWT — затем сбрасывает поток и снова читает 16 байт:
package mycrypto_test
import (
"bytes"
"crypto/rand"
"testing"
"testing/cryptotest"
)
func TestDeterministicEntropyStream(t *testing.T) {
cryptotest.SetGlobalRandom(t, 42)
firstChunk := make([]byte, 16)
if _, err := rand.Read(firstChunk); err != nil {
t.Fatalf("first rand.Read failed: %v", err)
}
cryptotest.SetGlobalRandom(t, 42)
secondChunk := make([]byte, 16)
if _, err := rand.Read(secondChunk); err != nil {
t.Fatalf("second rand.Read failed: %v", err)
}
if !bytes.Equal(firstChunk, secondChunk) {
t.Fatal("entropy stream did not reset deterministically")
}
t.Logf("deterministic_entropy_verified: len=%d bytes_match=%v", len(firstChunk), bytes.Equal(firstChunk, secondChunk))
}
Заметь: в коде нет заранее захардкоженного массива байтов. Первый вызов SetGlobalRandom(t, 42) задаёт точку отсчёта для firstChunk, второй обнуляет поток перед заполнением secondChunk, а bytes.Equal проверяет их побайтовое совпадение.
Чтобы отключить кэш тестов Go и честно прогнать сценарий заново, используют команду:
go test -v -count=1 ./...
Флаг -count=1 сбрасывает кэш, а лог теста подтверждает, что оба 16-байтовых чтения совпали бит в бит. Пойманного сида теперь хватает, чтобы локально воспроизвести сбой генерации ключей или токенов без переписывания кода под моки.
Но за глобальную подмену приходится платить двумя жёсткими ограничениями:
- Никакого
t.Parallel():SetGlobalRandomменяет генератор на весь процесс ОС, поэтому ни сам тест, ни его предки не должны быть параллельными — иначе тест упадёт с паникой. - Режим FIPS-140: при сборке с Go Cryptographic Module v1.0.0 (когда
crypto/fips140.Versionвозвращает"v1.0.0") функция не поддерживается.
Детерминизм в crypto/rand работает ровно до границы параллелизма и сертифицированного криптомодуля.
Если хочешь шире посмотреть на инструменты надёжности в языке, загляни в наш обзор релиза Go 1.27 и разбор фаззинг-тестирования в Go.
И главное предостережение лучше всего оставить за самой документацией testing/cryptotest: способ расходования случайности криптоалгоритмами в стандарте не зафиксирован и может меняться со временем — поэтому тест, ожидающий конкретного вывода криптофункции, может сломаться в будущей версии Go даже с SetGlobalRandom.



