`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 error | API ответил не тем форматом | 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 и содержимое пользовательского ответа удалите.