Для одного сломанного файла запишите точный URI, например /assets/app.abc123.css, и HTTP-ответ. Затем найдите location, который обслуживает этот URI, и вычислите путь на диске. Пока неизвестны выбранный блок и итоговый путь, изменение прав или try_files превращается в угадывание.
Различайте симптомы: 404 обычно означает неверный путь или отсутствующий релиз; 403 — запрет доступа, права на каталог или попытку открыть директорию; HTTP 200 с HTML вместо CSS — fallback приложения перехватил запрос. Браузер может показать одинаково «сломанные стили», но исправления у этих случаев разные.
URI превращается в путь по конкретному правилу
| Конфигурация | URI | Искомый путь |
|---|---|---|
| location /assets/ + root /srv/app/public | /assets/a.css | /srv/app/public/assets/a.css |
| location /media/ + alias /srv/uploads/ | /media/a.jpg | /srv/uploads/a.jpg |
| location / + root текущего release | /build/app.js | release/public/build/app.js |
| try_files $uri /index.php | /assets/missing.css | может уйти в приложение вместо честного 404 |
Директива root добавляет URI к заданному пути. Alias заменяет совпавшую часть location своим путём. Ошибка с завершающим slash часто заметна только на вложенных каталогах. Сначала выпишите преобразование строкой, затем сравните с реальным ls или stat на сервере.
Минимальный location не отдаёт HTML за CSS
location /assets/ {
root /srv/app/current/public;
try_files $uri =404;
access_log off;
expires 1y;
add_header Cache-Control "public, immutable";
}
location / { try_files $uri $uri/ /index.php?$query_string; }Это условный фрагмент: путь и политика кеша должны соответствовать вашему релизу. Долгий immutable-кеш подходит только файлам с content hash в имени. Для app.css без версии годовой кеш закрепит старое содержимое. Важная часть диагностики — отдельный static location с =404 до общего fallback.
Права проверяются на всём пути
- Worker nginx должен иметь право прохода x на каждом родительском каталоге.
- Конечный файл требует чтения, а каталог — не обязательно глобального 777.
- Symlink current должен указывать на существующий release, доступный worker.
- SELinux или другой MAC-профиль проверяется отдельно от обычных mode bits.
- Uploads не размещаются внутри каталога, который следующий deploy заменяет целиком.
Не исправляйте 403 рекурсивным chmod 777. Сначала определите пользователя worker, владельца файла и первый недоступный сегмент пути. Дайте минимальные права через владельца или группу и повторите запрос. Если действует SELinux, его audit log объяснит запрет, который обычный ls -l не показывает.
Победивший location виден по точечному логу
Проверьте итоговую конфигурацию после include и шаблонов, затем временно добавьте диагностический access log для одного пути или используйте существующие поля request_uri, status и sent_http_content_type. Error log при 404 часто показывает рассчитанный filename. Уберите повышенную детализацию после расследования, чтобы не раздувать диск.
Релиз и HTML переключаются согласованно
Хэшированные assets должны появиться на origin до HTML, который на них ссылается. При атомарном переключении current сохраняйте предыдущий release достаточно долго, чтобы старые страницы и кеши могли запросить его файлы, либо публикуйте assets в неизменяемое общее хранилище. Очистка старого каталога сразу после deploy создаёт выборочные 404.
Проверка охватывает ответ, тип и кеш
- Запросить один существующий CSS и получить 200 с text/css.
- Запросить несуществующий hashed asset и получить 404, а не HTML.
- Проверить JS, изображение и вложенный путь с тем же location.
- Сравнить ETag или Last-Modified при повторном запросе.
- Открыть страницу после переключения release и проверить все assets в Network.
- Повторить с origin и через CDN, если он участвует в маршруте.
Для разбора приложите URI, статус и Content-Type, выбранный фрагмент nginx-конфигурации, вычисленный абсолютный путь, права каждого каталога и строку error log без персональных данных. Этого набора достаточно, чтобы отличить root/alias, доступ, fallback и рассинхрон релиза.