Исправить Error occurred while trying to proxy request

Схема локального проксирования и ошибки запроса

Важно: все решения зависят от вашей среды (OS, версия Node, proxy middleware). Применяйте изменения по одному и проверяйте результат.

Быстрые предложения и реклама

BEST PRICES FOR март 2025

Private Internet Access — Поддержка 24/7. Акции и скидки зависят от поставщика.
Express VPN — Быстрые соединения и разные тарифы.
CyberGhost VPN — Фокус на протоколах безопасности.

(Это блок информации; он не влияет на технические шаги ниже.)

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

Коротко: сообщение «Error occurred while trying to proxy request» означает, что прокси-мидлварь (например http-proxy-middleware, HPM, или devServer proxy в webpack) не смогла установить или корректно переслать соединение к целевому серверу. Причины — сеть, несоответствие IP, неверные заголовки, порядок middleware, или неправильная конфигурация.

Определения в одну строку:

Proxy (прокси): промежуточный сервер, пересылающий запросы клиента на целевую конечную точку.
changeOrigin: настройка, изменяющая заголовок Host в запросе на целевой хост.

Шаги по исправлению (подробно)

1. Проверьте версию IP (IPv4 vs IPv6)

Почему: если ваш сервер слушает на IPv6-адресе (например ::1) а прокси пытается подключиться по IPv4 (127.0.0.1), соединение может падать.

Что сделать:

На сервере выполните (Linux/Mac):

ss -lntp | grep LISTEN
# или
netstat -lntp | grep LISTEN

Посмотрите, слушает ли процесс IPv6 (::1) или IPv4 (127.0.0.1).
Приведите сервер и прокси к одной версии IP: либо используйте ::1 в конфигурации прокси, либо укажите 127.0.0.1 на сервере.

Пример: если сервер слушает [::1]:8081, в прокси используйте именно [::1]:8081.

Important: иногда ОС сопоставляет ::1 и 127.0.0.1 по-разному — проверьте локальные настройки сети.

2. Добавьте changeOrigin в конфиг прокси

Почему: некоторые целевые серверы или API ожидают, что заголовок Host будет совпадать с целевым хостом. changeOrigin переключает Host на целевой.

Пример конфигурации proxy (Node/webpack HPM):

{
  "/api": {
    "target": "https://localhost:12345",
    "secure": false,
    "changeOrigin": true
  }
}

После добавления перезапустите dev-server и повторите запрос.

3. Проверьте webpack devServer proxy и используйте [::1] при необходимости

Почему: devServer поднимается на локальном хосте, и в Windows / некоторых системах IPv6 локалхост представлен как ::1.

Пример в webpack.config.js:

devServer: {
  proxy: {
    "*": "http://[::1]:8081"
    // "secure": false,
    // "changeOrigin": true
  }
},

Если ваш backend слушает на IPv6, укажите явный адрес [::1]. Это часто решает несоответствие адресов.

4. Отредактируйте файл hosts

Почему: иногда DNS/локальные записи неправильно резолвят localhost.

Что сделать:

Откройте системный файл hosts (на Windows — C:\Windows\System32\drivers\etc\hosts; на Linux/Mac — /etc/hosts) с привилегиями администратора.
Добавьте строку:

127.0.0.1 localhost

Сохраните файл и перезапустите процессы. На Windows может потребоваться очистить DNS-кеш: ipconfig /flushdns.

Скриншот содержимого файла hosts с записью localhost

5. Убедитесь, что body-parser не мешает proxy (порядок middleware)

Почему: если вы используете express и ставите body-parser перед HPM, middleware может «поглотить» запрос или изменить поток тела, мешая проксированию.

Решение: зарегистрируйте proxy middleware до body-parser либо полностью уберите body-parser при proxify, если он не нужен.

Пример правильного порядка:

const { createProxyMiddleware } = require('http-proxy-middleware');
app.use('/api', createProxyMiddleware({ target: 'http://127.0.0.1:8080' }));
app.use(express.json()); // body-parser после proxy

6. Добавьте заголовок Connection: keep-alive в клиентский proxy

Почему: явный заголовок может помочь поддерживать соединение и избежать неожиданных разрывов.

Пример:

module.exports = function(app) {
  app.use(proxy('/api', {
    target: 'http://127.0.0.1:8080/',
    headers: {
      "Connection": "keep-alive"
    }
  }));
};

Перезапустите клиент и сервер после изменения.

Диагностика: методика поиска причины

Мини-методология (шаги, пока не найдёте причину):

Повторите ошибку и скопируйте полное сообщение из консоли.
Посмотрите лог целевого сервера — доходит ли до него запрос.
Проверьте сетевые слушатели (ss/netstat) — на каком адресе слушает сервис.
Пробуйте менять одну настройку за раз (changeOrigin, адрес, hosts, порядок middleware).
Используйте curl или Postman с заголовками Host и Connection, чтобы эмулировать запросы.

Когда эти решения не помогут — альтернативные подходы

Проверьте брандмауэр/антивирус: локальные правила могут блокировать порты.
Пассировать трафик через внешний прокси/NGINX и посмотреть, где ломается соединение.
Временно включите подробное логирование http-proxy-middleware (debug) и нативных модулей Node.
Попробуйте запустить сервер и клиент в одной сети/контейнере для исключения сетевых проблем.

Роль‑ориентированные чек-листы

Для фронтенда:

Проверить changeOrigin и target в proxy.
Попробовать 127.0.0.1 vs [::1].
Очистить кеш браузера.

Для бэкенда/DevOps:

Проверить, на каком интерфейсе слушает приложение.
Проверить firewall/iptables/uFW.
Просмотреть логи приложения и прослушивающие сокеты.

Для QA:

Воспроизвести шаги и сохранить точный стек ошибки.
Проверить конфигурацию hosts на тестовой машине.

Критерии приёмки

Клиентские запросы к /api успешно проксируются и возвращают ожидаемые HTTP-статусы.
Логи прокси и целевого сервера показывают установку соединения и корректную пересылку.
Нет нестабильных обрывов (проверить несколько последовательных запросов).

Частые случаи, когда это не работает

Если целевой сервер использует TLS с самоподписанным сертификатом, установите secure: false и/или добавьте доверие к сертификату.
Если используются контейнеры Docker, проверьте, что network_mode и адреса соответствуют ожиданиям.
При корпоративных прокси/HTTP-инспекциях заголовки и сертификаты могут меняться.

Безопасность и приватность

Не отключайте проверку сертификатов в production (secure: false только для локальной разработки).
Не публикуйте содержимое hosts и приватные адреса в публичных репозиториях.

Краткое резюме

Основные причины: несоответствие IP-версий, заголовок Host, порядок middleware, файл hosts и настройка соединения.
Проверяйте и меняйте по одному параметру; фикс обычно находится среди перечисленных шагов.

Summary:

Проверьте IPv4/IPv6 и используйте [::1], если нужно.
Добавьте changeOrigin и при необходимости Connection: keep-alive.
Убедитесь, что body-parser не мешает прокси.
Редактируйте hosts и проверяйте логи целевого сервера.

Если проблема не решается — сохраните логи, опишите окружение (OS, Node, версии пакетов) и откройте issue в репозитории мидлвари с минимальным воспроизводимым примером.