curl: (22) The requested URL returned error — сервер ответил ошибкой
Сервер ответил кодом 400 или выше, а в команде стоит ключ -f. Подключение прошло, ошибку вернул сам сайт: что случилось, говорит число в конце строки — код ответа.
Содержание 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 |
502 | nginx не получил нормального ответа от PHP или приложения | 502 Bad Gateway |
503 | сервер перегружен или закрыт на обслуживание | 503 Service Unavailable |
504 | nginx не дождался ответа от 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 ….
Источники
- Исходный код curl 8.5.0: lib/http.c и curl 8.18.0 — строка The requested URL returned error и коды, при которых срабатывает ключ -f.
- Исходный код curl 8.5.0: src/tool_operate.c и curl 8.18.0 — ключ --fail-with-body, повтор при кодах 408, 429, 500, 502, 503, 504 и строка Will retry.
- Документация curl — ключи -f, --fail-with-body, --retry, -D и -u.
- Исходный код curl 8.5.0: lib/strerror.c и curl 8.18.0 — названия кодов выхода.
- Пакет curl в Ubuntu 24.04 и в Ubuntu 26.04 — версии 8.5.0 и 8.18.0.
Сверено 23 октября 2026 года.
Что почитать дальше
- 404 Not Foundкогда страницы или файла нет.
- 503 Service Unavailable.
- Как скачать файл на сервер: wget и curl.
- Все ошибки curlтаблица по коду и тексту.