Java SocketTimeoutException: что означает исключение

Что означает ошибка

Истёк настроенный таймаут операции чтения, accept или connect в сокетном API.

Возможные причины

• Удалённый сервис отвечает дольше configured timeout.
• Сеть теряет пакеты или соединение зависает.
• Таймаут слишком мал для конкретной операции.

Что проверить

• Определите, какая именно операция timed out.
• Сопоставьте таймаут приложения с метриками latency сервера.
• Проверьте трассу через proxy/load balancer и серверные логи.

Безопасные шаги

1. Устраните задержку на сервисе или сети.
2. Настройте раздельные connect/read timeouts под SLO.
3. Добавляйте retries только для безопасных операций с ограничением количества попыток.

Только безопасные обратимые действия. Опасные шаги — только по официальной инструкции и с пониманием рисков.

Когда нужен сервис

• Если таймаут повторяется при нормальной сети, зафиксируйте configured timeout, этап операции и адрес peer и передайте эти данные владельцу клиента или удалённого сервиса.

Похожие ошибки

• /errors/java-illegalargumentexception/
• /errors/java-illegalstateexception/
• /errors/java-indexoutofboundsexception/

Что учитывать

Точная причина зависит от версии ПО/прошивки, полного текста ошибки и контекста. Официальная инструкция имеет приоритет.

Официальный источник

Расшифровка сверена с официальными страницами поддержки из источников ниже. Редакция N1RO не диагностировала ваш конкретный случай.

• Oracle Java SE 21 API — SocketTimeoutException