`localhost` внутри Android Emulator указывает на сам эмулятор, а не на компьютер с backend. Для стандартного Android Emulator специальный адрес `10.0.2.2` ведёт к loopback интерфейсу host-машины. Замените только host в development base URL и сначала откройте простой `/health` из браузера эмулятора.

Если health не открывается, React Native ещё не участвует в проблеме. Убедитесь, что backend слушает нужный порт, host firewall не блокирует процесс, а корпоративный proxy не перехватывает запрос. На реальном телефоне `10.0.2.2` не работает: там нужен адрес компьютера в LAN или туннель.

Ошибка сообщает, какой слой проверять

СимптомВероятная границаПроверка
Connection refusedНа адресе и порту никто не слушаетBase URL, порт и bind backend
TimeoutМаршрут, firewall или proxyОткрыть тот же URL в браузере эмулятора
Cleartext traffic not permittedПолитика Android для HTTPИспользовать HTTPS либо узкое debug-исключение
SSL handshake/certificate errorНедоверенный или неверный TLS certificateЦепочка, hostname и срок сертификата
HTTP 401/403Сеть работает, отказала авторизацияHeader, audience токена и server log по request ID
JSON parse errorAPI ответил не тем форматомStatus, Content-Type и начало body без секретов

Сообщение `Network request failed` слишком общее. Добавьте безопасный лог URL без query, method, duration и класс нативной ошибки. Не печатайте Authorization и тело ответа целиком. На backend свяжите запрос по request ID.

Development base URL задаётся явно

const API_BASE_URL = __DEV__
  ? 'http://10.0.2.2:3000'
  : 'https://api.example.com';

export async function loadHealth() {
  const response = await fetch(`${API_BASE_URL}/health`);
  if (!response.ok) {
    throw new Error(`health_http_${response.status}`);
  }
  return response.json();
}

Не собирайте production с условным локальным адресом. Лучше генерировать environment-specific config и показывать выбранное окружение в debug-экране. Если используется Expo Go или другое окружение, его сетевой маршрут может отличаться; проверяйте документацию именно запускаемого клиента.

HTTP и HTTPS дают разные отказы

React Native напоминает, что Android начиная с API level 28 по умолчанию блокирует cleartext traffic. Основной путь — локальный HTTPS с доверенным сертификатом либо защищённый dev-туннель. Если нужен HTTP для локальной разработки, ограничьте разрешение debug-конфигурацией и конкретным доменом; не отключайте сетевую защиту во всём production manifest.

Самоподписанный сертификат без доверия устройства не становится рабочим от добавления `https://`. Сравните hostname сертификата с URL и установите dev CA только в контролируемое тестовое окружение. Обход проверки TLS в JavaScript или нативном коде нельзя оставлять даже временно в общей ветке.

Bind backend может быть вторым барьером

  • Подтвердите порт командой или журналом самого backend.
  • Проверьте health endpoint без авторизации и редиректов.
  • Сравните bind на 127.0.0.1 и 0.0.0.0 с требованиями выбранного маршрута.
  • Разрешите вход только нужному процессу и профилю firewall.
  • Не публикуйте development database или admin endpoints в общую сеть.

Для обычного Android Emulator адрес 10.0.2.2 специально отображается на host loopback, поэтому сервер на loopback часто достижим через этот alias. Docker, WSL, удалённый dev container и VPN добавляют ещё одну границу: запрос может дойти до host, но не до контейнера. Сначала тестируйте порт на каждом переходе.

Проверка заканчивается production-подобным запросом

После `/health` выполните реальный GET без персональных данных, затем запрос с тестовой авторизацией. Проверьте status, Content-Type и JSON. Повторите на реальном устройстве с production-like HTTPS: исправление для эмулятора не доказывает корректность DNS, сертификата и сетевых правил релиза.

Для разбора нужны версия Android Emulator, base URL без секретных query, порт, тип запуска backend, ошибка fetch и server log по request ID. Access token и содержимое пользовательского ответа удалите.

Проверенные источники