Файл на диске и работающая конфигурация nginx могут различаться. Неприменённая правка ничего не меняет в трафике; синтаксически верная правка может маршрутизировать запросы неправильно. Нужны обе проверки.
Найди нужный server и location
nginx -T проверяет конфигурацию и выводит прочитанные файлы, включая include. Сопоставь listen, server_name, location и путь к upstream или статике с конкретным URL. Вывод может содержать чувствительные настройки.
sudo nginx -Troot дополняется URI запроса, а alias заменяет соответствующий location префикс. Для ошибки статики сравни итоговый путь с реальным файлом.
Сначала проверь синтаксис
После небольшой правки запусти nginx -t. При ошибке прочитай файл и номер строки, исправь и повтори проверку. Успешный тест не проверяет доступность backend или выполнение JavaScript в браузере.
sudo nginx -tnginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successfulСообщения и путь зависят от сборки. Важен успешный код завершения проверки.
Примени и повтори тот же запрос
nginx -s reload просит мастер-процесс перечитать конфигурацию. Новые worker-процессы принимают новые соединения, старые завершают обслуживание текущих. Проверь error.log и воспроизведи исходный запрос с тем же Host.
sudo nginx -t && sudo nginx -s reload
curl -sS -i --max-time 5 -H 'Host: shop.example.test' http://127.0.0.1/Если результат неверный, сравни ожидаемое поведение с логами и откати конкретную правку при необходимости. Не меняй несколько несвязанных параметров одновременно.
Раздели проксирование и выдачу статики
Для 502 проверяй адрес upstream и доступность приложения. Для белого экрана со статусом 200 — HTML, URL assets и Content-Type. Одна и та же проверка nginx -t помогает не сломать синтаксис, но причины находятся в разных частях конфигурации.
Вмешательства делай по одной гипотезе: сохрани прежний фрагмент, измени нужный location или путь, проверь и примени. Сравнение до/после на одинаковом URL показывает эффект лучше, чем одновременная перестройка всех server-блоков.
Если nginx уже успешно читает конфигурацию, отсутствие синтаксической ошибки не исключает неверный upstream, root или alias.
От симптома к проверке
| Наблюдение | Следующая проверка | Как читать результат |
|---|---|---|
| nginx -t failed | Названные файл и строка | Сначала устрани ошибку проверки конфигурации. |
| nginx -t успешен, HTTP 502 | proxy_pass и прямой backend | Синтаксис верен, но адрес или приложение могут быть неверны. |
| JS получает неверный MIME | location, alias/root и файл | Проверь реальный ресурс вместо отключения проверки браузера. |
Типовые ошибки
- Перезапустить весь сервер вместо небольшого проверенного reload.
- Удалить include, не понимая, что он настраивает.
- Считать существование файла доказательством его выдачи по нужному URL.
Как доказать восстановление
- Сохрани успешный nginx -t перед применением.
- Проверь reload и новые ошибки master/worker.
- Повтори одинаковый URL и Host до и после изменения.
- Для статики проверь браузер; для прокси — бизнес-запрос backend.
МИНИ-ИНЦИДЕНТ
Файл есть, но браузер его не исполняет
На диске есть новый JS, в HTML старое имя, а location /assets/ смотрит в прошлый релиз. Почему одной правки Content-Type недостаточно?
HTML: /assets/app-old.js
files: /srv/www/assets/app-new.js
location: /srv/previous-release/assets/Разобрать ход диагностики
Нужно согласовать ссылку, путь выдачи и тип содержимого, затем проверить полученный ресурс и интерфейс. MIME-заголовок не создаёт отсутствующий файл и не меняет URL в HTML.
ПРАКТИКУМ
Практикум: объясни данные и выбери действие
Проверка синтаксиса успешна, но путь ассета попадает не в тот обработчик.
GET /assets/bundle.js → 200 text/html
GET /api/orders → 200 application/json
nginx -t → successfulПочему глобальное «nginx работает» слишком широко?
Сверить рассуждение
Разные пути обслуживаются разными location и backend. Успех API не проверяет выдачу статики, а синтаксис не устанавливает соответствие URL ожидаемому файлу.
Что искать в effective configuration?
Сверить рассуждение
Нужный server по Host, правила location, root/alias, fallback и MIME. Сопоставляй их с точным URL запроса, включая относительный путь после выбранного location.
Какая последовательность подтверждает исправление?
Сверить рассуждение
Синтаксис, применение конфигурации и GET нужного ресурса с проверкой тела и типа. Для JavaScript затем нужна загрузка страницы в браузере, потому что curl не исполняет приложение.
ПРОВЕРЬ СЕБЯ
nginx -t прошёл. Это доказывает, что сайт исправен?
Показать объяснение
Нет. Это проверка конфигурации, а не пользовательского сценария. После reload проверь ответ, ресурсы страницы и нужное действие в браузере.
Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.