Гайды

Почему CSP блокирует мои собственные скрипты — три причины и как починить

Иллюстрация: охранник заворачивает курьера с посылкой от своего же склада

Симптом узнаваемый: добавил заголовок безопасности — кнопки перестали нажиматься, часть блоков пропала, страница может быть вообще белой. В консоли красное:

Refused to execute inline script because it violates the following
Content Security Policy directive: "script-src 'self'"

Ключевое слово в этой ошибке — inline. Не «вредоносный», не «чужой». CSP смотрит только на источник кода, и у кода, написанного прямо в HTML, источника нет. Разберём три причины по частоте — почти всегда твой случай первый.

Причина 1. Скрипт написан прямо в HTML

Самая частая, особенно если разметку помогал писать ИИ: он охотно ставит обработчики в атрибуты и мелкие скрипты прямо в страницу.

Как проверить. В ошибке есть слово inline, а в номере строки — сам HTML-документ, а не файл .js. Ищи в разметке две вещи: теги script без атрибута src и атрибуты-обработчики вида onclick=, onload=, onsubmit=.

Как починить. По убыванию надёжности:

  1. Вынести код в отдельный файл и подключить через src. Тогда у него появляется адрес, и 'self' его пропускает. Это чинит большинство случаев и не требует правок политики.
  2. Обработчики из атрибутов перевести на addEventListener в том же файле.
  3. Если вынести нельзя — выдавать серверу одноразовое число (nonce) и класть его в заголовок и в каждый свой скрипт. Учти: число должно быть новым на каждый ответ, поэтому на чисто статическом хостинге этот путь не работает.

То же самое касается стилей: style-src блокирует теги style и атрибуты style="..." ровно по той же логике.

Причина 2. Директива в ошибке — не та, о которой ты думаешь

Второй по частоте случай: со скриптами всё в порядке, но не грузятся шрифты, картинки или падают запросы к API.

Как проверить. Прочитай в тексте ошибки, какая именно директива сработала. Их несколько, и каждая отвечает за своё:

  • script-src-elem — подключение файлов скриптов;
  • style-src — стили, в том числе с чужого домена;
  • font-src — шрифты (частый сюрприз: шрифты Google лежат на отдельном домене);
  • img-src — картинки, включая аватарки из внешнего сервиса;
  • connect-src — запросы через fetch, WebSocket, отправка аналитики.

Тут работает главное правило default-src: если ты задал только его, он становится запасным вариантом для всех типов ресурсов сразу. Разрешил default-src 'self' — значит, запретил и шрифты со стороны, и запросы к чужому API.

Как починить. Добавляй домены точечно, по одной директиве, глядя в консоль. Не сваливай всё в default-src и тем более не пиши default-src * — это возвращает страницу в исходное «выполняй что угодно».

Кстати, если запрос к API падает, но в ошибке нет слова CSP, а есть blocked by CORS policy — это другая история и лечится на сервере: что такое CORS.

Причина 3. Ты добавил 'unsafe-inline', а он не работает

Самая обидная. Ты сдался, дописал в политику 'unsafe-inline' — и ничего не изменилось.

Почему так. Если в той же директиве рядом стоит 'nonce-...' или хэш, браузер намеренно игнорирует 'unsafe-inline'. Это не баг: 'unsafe-inline' там задуман как запасной вариант для старых браузеров, которые про nonce не знают. Новый браузер видит nonce — и требует его от каждого inline-скрипта.

Как проверить. Посмотри полный заголовок в инструментах разработчика: вкладка Network → первый запрос документа → Response Headers. Если в script-src соседствуют nonce (или sha256-...) и 'unsafe-inline' — вот и объяснение.

Как починить. Выбери одну схему. Либо nonce/хэши — и тогда каждый свой inline-скрипт помечаешь. Либо файлы плюс 'self' — и тогда inline-кода нет вовсе. Смешивать бессмысленно.

Ещё две ловушки, если ни одна причина не подошла

Заголовков CSP два. Свой ты поставил в приложении, а второй дописал хостинг, прокси или CDN. Браузер применяет каждую политику отдельно, и ресурс должен пройти обе — на деле работает самая строгая. Смотри Response Headers: если строк Content-Security-Policy две, чинить надо ту, что пришла сверху.

Ты положил политику в тег meta, а ждёшь режима отчётов. Report-Only через meta не работает вообще — только настоящим заголовком ответа. И политика из meta начинает действовать с того места документа, где встретилась, поэтому всё, что грузилось выше, к ней не относится. Заголовок надёжнее по обеим причинам.

Порядок действий, если некогда разбираться

  1. Переключи заголовок на Content-Security-Policy-Report-Only — сайт немедленно оживёт, а нарушения продолжат писаться в консоль.
  2. Пройди по всем страницам, собери список нарушений: какая директива и какой домен.
  3. Вынеси inline-скрипты в файлы — это снимет большую часть списка.
  4. Добавь оставшиеся домены точечно.
  5. Верни боевой заголовок и проверь ещё раз.

Механика директив и три способа разрешить свой код разобраны в базовой статье что такое CSP, а куда физически вписать заголовок на Vercel, Netlify и nginx — в гайде по заголовкам безопасности.

Почему локально работает, а на проде — нет?

Обычно потому, что заголовок ставит не приложение, а хостинг или прокси, которых на твоей машине нет. Проверь ответ прода через curl -sI и сравни с локальным — разница будет видна сразу.

Можно просто убрать CSP и жить дальше?

Можно, сайт заработает. Но ты снимаешь второй слой защиты именно там, где он полезнее всего, — на публичной странице с чужими виджетами. Разумнее оставить Report-Only и доводить политику постепенно.

Библиотека падает с ошибкой про eval — это тоже CSP?

Да. Как только в политике появляется default-src или script-src, eval() и его аналоги выключаются автоматически. Правильный путь — обновить или заменить библиотеку; ослаблять политику ради неё стоит в последнюю очередь. Как подступиться к чужой ошибке, разобрано в статье как чинить баги вместе с ИИ.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →