必须在字体文件所在服务端配置access-control-allow-origin响应头,仅前端加crossorigin: anonymous无效;因该属性仅触发cors请求模式,若服务端未返回对应响应头,浏览器即拦截字体加载并报“no 'access-control-allow-origin' header is present”错误。

必须在字体文件所在服务端配置 Access-Control-Allow-Origin 响应头,仅前端加 crossorigin: anonymous 无效。
为什么加了 crossorigin: anonymous 还报错?
浏览器看到 @font-face 中的 crossorigin: anonymous,会以 CORS 模式发起字体请求(如 .woff2),但若服务端响应中没有 Access-Control-Allow-Origin 头,请求立刻被拦截——控制台报错典型格式是:
Font from origin 'https://cdn.example.com' has been blocked from loading by Cross-Origin Resource Sharing policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.
- 这个错误和 CSS 文件本身是否跨域无关,只取决于字体文件响应头
-
crossorigin: anonymous只是“发起请求的方式”,不是“绕过限制的开关” - 如果字体请求带凭证(如 cookie),
Access-Control-Allow-Origin: *会被浏览器拒绝,必须写具体域名
Nginx 配置字体 CORS 的关键细节
不能只在 http 或 server 块里全局加 add_header Access-Control-Allow-Origin *,必须用 location 精确匹配字体后缀,并确保 always 标志生效:
location ~* \.(woff2?|ttf|eot|otf|svg)$ {
add_header Access-Control-Allow-Origin "https://yourapp.com" always;
add_header Access-Control-Allow-Methods "GET" always;
add_header Access-Control-Allow-Headers "X-Requested-With, Content-Type" always;
add_header Access-Control-Max-Age "31536000" always;
}
- 正则要覆盖所有实际用到的后缀:
.woff2、.woff、.ttf、.eot、.otf(.svg虽少用也建议加上) -
always很关键:否则 304/404 响应不会带 CORS 头,导致缓存或错误路径下仍失败 - 如果用了 CDN,确认它透传源站响应头;很多 CDN 默认不缓存
add_header,需单独开启“缓存响应头”选项
替代方案:什么时候该考虑 base64 或代理?
当你无法控制字体服务器(比如用的是第三方 iconfont CDN,且对方不支持白名单配置),才转向降级方案:
-
转 base64:适合图标字体(体积小),用 transfonter.org 转换后直接嵌入
@font-face的src,例如:src: url(data:font/woff2;base64,...) format('woff2');—— 缺点是增大 CSS 体积、无法利用浏览器字体缓存 -
反向代理:在你自己的 Nginx 上配一个
location /fonts/,proxy_pass https://cdn.example.com/fonts/;,让字体请求走同源路径 —— 注意代理后仍要加 CORS 头,除非完全内网化 -
别用
*+ 凭证:如果页面已登录且字体请求自动带 cookie,Access-Control-Allow-Origin: *会失效,必须写死域名
最容易被忽略的一点:检查 Network 面板里实际被拦住的资源是哪个文件——经常是 .woff2 成功了,但 fallback 的 .ttf 或 .eot 没配 CORS,浏览器静默降级失败,图标就变方块。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











