网站提示CSP拦截:脚本为什么无法执行
网站按钮失效、脚本加载失败时,如果浏览器控制台出现Content Security Policy或Refused to execute script,应先查清哪个资源被哪条策略拦截。CSP可能由应用、Web服务器、代理或CDN添加,单纯修改某个配置文件,不代表浏览器收到的策略已经改变。
一、从完整报错定位资源与指令
打开开发者工具的“控制台(Console)”,刷新出错页面,记录页面地址、被拦资源URL及报错提到的指令。若资源标为inline,通常需要检查页面内的脚本或事件代码。
| 报错指令 | 主要检查对象 |
|---|---|
| script-src-elem、script-src | script元素引用的文件或内联脚本 |
| script-src-attr | onclick等写在HTML属性中的事件代码 |
| connect-src | fetch、XHR、WebSocket等连接 |
没有配置更具体的指令时,浏览器可能回退使用script-src或default-src。按报错注明的实际指令排查,不要看到网页按钮失效就只改script-src。
二、查看出错页面真正收到的策略
切换到“网络(Network)”,在开发者工具保持打开时勾选“停用缓存”,刷新后选择主页面的document请求,查看“响应标头”。嵌入框架内的错误,应检查对应框架页面。重点记录全部Content-Security-Policy与Content-Security-Policy-Report-Only。
前者会执行限制;后者只观察违规,不会单独阻止脚本。如果控制台提示仅报告而脚本仍失败,应继续找强制策略或其他报错。还要检查页面是否包含<meta http-equiv="Content-Security-Policy">,它也可能参与限制。
Linux终端可以对实际页面发起GET请求查看响应头:
curl -sS -D - -o /dev/null 'https://example.com/page'
把URL换成自己的最终页面地址。需要登录的页面以已登录浏览器中的响应为准;未带会话的curl可能得到登录页或跳转,不能拿那份策略代表业务页面。
三、多个策略需要同时满足
同一页面存在多条强制策略时,资源必须通过每一条。新增一个宽松响应头不会覆盖原来的限制。例如应用允许某脚本域名,但代理仍返回script-src 'self',外部脚本仍可能被拦。
对照应用设置、站点配置及代理/CDN响应头规则,找到每条策略的来源,保存原配置后只修改负责该限制的位置。不要不断叠加新的CSP头,也不要只检查服务器上的文件而忽略浏览器实际响应。
四、按脚本类型做最小调整
普通来源白名单策略中,先核对脚本URL是否正确、来源是否可信,再精确补充需要的HTTPS主机或路径。采用nonce、hash或strict-dynamic的策略,应沿用原有机制,添加域名不一定能解决。
动态内联脚本使用nonce时,应由服务端为每次HTML响应生成不可预测的随机值,并让策略中的nonce与目标script元素一致。不要把示例值写死;页面缓存和响应头生成也必须保持一致。
固定内联脚本可以使用内容hash,脚本的空格、换行或压缩结果变化后都要重新核对。nonce用于script元素,不能直接解决onclick属性;此类事件可迁移到受允许脚本中的addEventListener()。若报错涉及eval,应检查代码或构建方式,不要全站放开。
五、修改后验证功能与最终响应
新策略可以先在测试页面用Report-Only观察,保留原有强制策略。发布后重新读取页面响应头,确认需要的脚本能够加载,并实测登录、弹窗、表单和延迟加载内容。只看到首页没有红字,不代表所有页面完成验收。
不要通过全站添加'unsafe-inline'、'unsafe-eval'或关闭CSP解决问题。需要协助时,提供页面地址、完整报错、被拦资源及全部CSP响应头;URL中的令牌和业务信息先遮住。