Почему 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=.
Как починить. По убыванию надёжности:
- Вынести код в отдельный файл и подключить через
src. Тогда у него появляется адрес, и'self'его пропускает. Это чинит большинство случаев и не требует правок политики. - Обработчики из атрибутов перевести на
addEventListenerв том же файле. - Если вынести нельзя — выдавать серверу одноразовое число (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 начинает действовать с того места документа, где встретилась, поэтому всё, что грузилось выше, к ней не относится. Заголовок надёжнее по обеим причинам.
Порядок действий, если некогда разбираться
- Переключи заголовок на
Content-Security-Policy-Report-Only— сайт немедленно оживёт, а нарушения продолжат писаться в консоль. - Пройди по всем страницам, собери список нарушений: какая директива и какой домен.
- Вынеси inline-скрипты в файлы — это снимет большую часть списка.
- Добавь оставшиеся домены точечно.
- Верни боевой заголовок и проверь ещё раз.
Механика директив и три способа разрешить свой код разобраны в базовой статье что такое CSP, а куда физически вписать заголовок на Vercel, Netlify и nginx — в гайде по заголовкам безопасности.
Почему локально работает, а на проде — нет?
Обычно потому, что заголовок ставит не приложение, а хостинг или прокси, которых на твоей машине нет. Проверь ответ прода через curl -sI и сравни с локальным — разница будет видна сразу.
Можно просто убрать CSP и жить дальше?
Можно, сайт заработает. Но ты снимаешь второй слой защиты именно там, где он полезнее всего, — на публичной странице с чужими виджетами. Разумнее оставить Report-Only и доводить политику постепенно.
Библиотека падает с ошибкой про eval — это тоже CSP?
Да. Как только в политике появляется default-src или script-src, eval() и его аналоги выключаются автоматически. Правильный путь — обновить или заменить библиотеку; ослаблять политику ради неё стоит в последнюю очередь. Как подступиться к чужой ошибке, разобрано в статье как чинить баги вместе с ИИ.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





