Для одного сломанного файла запишите точный 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.jsrelease/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.

Проверка охватывает ответ, тип и кеш

  1. Запросить один существующий CSS и получить 200 с text/css.
  2. Запросить несуществующий hashed asset и получить 404, а не HTML.
  3. Проверить JS, изображение и вложенный путь с тем же location.
  4. Сравнить ETag или Last-Modified при повторном запросе.
  5. Открыть страницу после переключения release и проверить все assets в Network.
  6. Повторить с origin и через CDN, если он участвует в маршруте.

Для разбора приложите URI, статус и Content-Type, выбранный фрагмент nginx-конфигурации, вычисленный абсолютный путь, права каждого каталога и строку error log без персональных данных. Этого набора достаточно, чтобы отличить root/alias, доступ, fallback и рассинхрон релиза.

Проверенные источники