Поиск
Ошибки

curl: (22) The requested URL returned error — сервер ответил ошибкой

Сервер ответил кодом 400 или выше, а в команде стоит ключ -f. Подключение прошло, ошибку вернул сам сайт: что случилось, говорит число в конце строки — код ответа.

≈ 6 мин чтения
Содержание 9

Как выглядит ошибка

curl: (22) The requested URL returned error: 404

Число в конце — код ответа сервера, у вас он может быть другим. Номер в скобках — код выхода curl. В скрипте его покажет команда echo $? сразу после curl. Тексты сверены с исходным кодом curl 8.5.0 — эта версия ставится из пакетов Ubuntu 24.04 — и curl 8.18.0 из пакетов Ubuntu 26.04.

Эту строку curl выводит, только когда в команде есть ключ -f (он же --fail) или --fail-with-body. Без них curl принимает любой ответ сервера: сохраняет страницу с ошибкой вместо файла и завершается с кодом 0. Ключ -f ставят в скриптах как раз для того, чтобы ошибка сайта не превратилась молча в «скачанный» файл.

Что значит число в конце

КодЧто случилосьПодробный разбор
401нужен логин и пароль или ключ доступа401 Unauthorized
403доступ запрещён: нет прав на файл, закрыт каталог или запрет в настройках сервера403 Forbidden
404по этому адресу ничего нет: опечатка в ссылке, файл удалили или переместили404 Not Found
429слишком много запросов, сервер просит подождать429 Too Many Requests
500сбой в программе сайта, причина — в журнале ошибок500 Internal Server Error
502nginx не получил нормального ответа от PHP или приложения502 Bad Gateway
503сервер перегружен или закрыт на обслуживание503 Service Unavailable
504nginx не дождался ответа от PHP или приложения504 Gateway Timeout

Как увидеть ответ сервера

С ключом -f curl не выводит тело ответа — страницу, на которой сайт объясняет, что пошло не так. Чтобы её увидеть, замените -f на --fail-with-body: код выхода останется 22, а ответ выведется на экран или сохранится в файл.

curl -sS --fail-with-body https://example.com/api/status

Ключ --fail-with-body есть в curl начиная с версии 7.76.0, то есть в Ubuntu 22.04 и новее. Заголовки ответа покажет ключ -D -, а сам файл ключ -o /dev/null выбросит:

curl -sS -D - -o /dev/null 'https://example.com/file.zip'

Первая строка вывода — версия HTTP и код, например HTTP/2 404. Если среди заголовков есть Retry-After, в нём сервер сообщает, когда повторить запрос.

Если код 404: проверьте ссылку

Откройте ссылку из команды в браузере. Если и там «не найдено», ссылка устарела: возьмите новую на странице, откуда брали эту. Если в браузере файл открывается, а curl получает 404, сравните ссылки по знакам: регистр букв, пробел, & и ?. Ссылку в команде берите в одинарные кавычки: без них знаки &, ?, пробел и скобки понимает по-своему терминал, и до curl доходит не та ссылка.

Если код 401 или 403

Сайт требует входа или запрещает доступ. Если страница закрыта логином и паролем на уровне сервера, передайте логин ключом -u — пароль curl спросит сам, символы при вводе не видны:

curl -f -u user -O 'https://example.com/private/file.zip'

Для API ключ доступа передают заголовком; каким именно, написано в документации сервиса. Если 403 отдаёт ваш собственный сервер, nginx не может прочитать файл или каталог — шаги в статье 403 Forbidden.

Если код 429 или от 500 до 504: повторите позже

Эти коды значат, что сбой на стороне сервера или он просит подождать. Повторить запрос curl может сам — ключом --retry с числом попыток:

curl -f --retry 3 -O 'https://example.com/file.zip'

curl повторит запрос до трёх раз, если сервер ответит кодом 408, 429, 500, 502, 503 или 504 либо выйдет время ожидания. Перед первым повтором он ждёт секунду, дальше пауза каждый раз удваивается. Если сервер прислал заголовок Retry-After, curl ждёт столько, сколько в нём сказано. Перед каждым повтором появится строка:

Warning: Problem : HTTP error. Will retry in 1 seconds. 3 retries left.

В curl 8.18.0 в ней написано 1 second. При кодах 401, 403 и 404 curl не повторяет: от повтора ответ не изменится. Если коды от 500 до 504 отдаёт ваш сервер, разберите их по шагам: 500, 502, 503, 504.

Как проверить

curl -sS -o /dev/null -w '%{http_code}\n' 'https://example.com/file.zip'

Команда выведет код ответа. 200 — файл отдаётся, код 400 и выше — ошибка осталась. Если в команде есть ключ -s, curl молчит и об ошибках. Чтобы увидеть текст ошибки, добавьте -S: curl -sS ….

Источники

Сверено 23 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше