av
2559d09fc8
- признаки «работы нет» и «задача не найдена» узнаются по смыслу, а не приведением типа: обёртка `%w` на пути больше не превращает пустой прогон воркера в отказ раз в секунду - отказ закрытия соединения с распознавателем доходит до вызывающего (`errors.Join`) либо до журнала; у `errcheck` включён `check-blank`, иначе критерий принимал реализацию, выбрасывающую отказ в пустоту - заведены первые тесты пакета worker и capability `pipeline`; долг из четырёх замечаний линтера закрыт, гейт зелёный целиком
3.1 KiB
gRPC-клиент SpeechKit: когда закрытие вообще может отказать
Отвечает на вопрос, возникший по ходу задачи errors-as-instead-of-typecast: что
означает отказ Close у клиента SpeechKit и стоит ли писать его в журнал.
Наблюдение понадобилось потому, что первая редакция кода и обоснования описывала
этот отказ неверно — как признак недоступности Yandex.
Как снималось
Не замером, а чтением исходников зависимости, зафиксированной в go.mod:
google.golang.org/grpc версии v1.74.2. Смотрел два места в
clientconn.go — конструктор клиента и метод Close. К Yandex ни разу не
обратился: ни на живых ключах, ни на тестовых.
Что выяснилось
grpc.NewClientсоединения не открывает. Клиент создаётся в состоянии ожидания, сеть трогается при первом вызове (clientconn.go:145). То есть на пути отказа конструктора — когда первый клиент создан, а второй нет — закрывать ещё нечего.(*ClientConn).Closeвозвращает ровно два исхода (clientconn.go:1142-1156):nilлибоErrClientConnClosing—codes.Canceled, «grpc: the client connection is closing» (clientconn.go:67). Второй наступает только при повторном закрытии уже закрытого клиента.
Что из этого следует для нас
Отказ Close в этом проекте означает нашу ошибку — закрыли дважды, а не сбой
или недоступность Yandex. Поэтому запись в журнале при остановке процесса
адресует владельца к нашему коду; так она и сформулирована.
Обработка отказа при этом оставлена в обоих местах, хотя сегодня он практически недостижим: она стоит одну строку и переживёт смену клиента, а её отсутствие пришлось бы обосновывать заново каждому читателю. Решение и его цена — ADR, обоснование целиком — в архивном design.md, Решение 2.
Наблюдение привязано к версии. Сменится мажорная версия grpc — перечень
исходов Close надо перечитать, а не считать его прежним.