字体加载失败主因是CORS校验拦截而非文件缺失:需确保Network中字体请求含Origin头、响应头精确匹配Access-Control-Allow-Origin、预检OPTIONS成功返回204,且Nginx正确匹配带参数路径并配置MIME类型。

字体加载失败时 Network 面板里看到状态码 0 或 CORS error
这不是文件不存在,而是浏览器在 CORS 校验阶段主动拦截了响应。典型表现是:文字突然回退成系统默认字体、控制台报 Access to font at 'https://cdn.example.com/icon.woff2' from origin 'https://your-site.com' has been blocked by CORS policy,但直接粘贴那个 URL 到新标签页能正常下载。
- 先确认请求是否发出:在 Network 面板过滤
.woff2或.ttf,点开该请求 → 查看「Headers」→ 看 Request Headers 是否含Origin: https://your-site.com;没有说明根本没走 CORS 流程(比如漏了crossorigin) - 再查响应头:Response Headers 里必须有
Access-Control-Allow-Origin,且值不能是*(如果前端用了crossorigin="use-credentials") - 注意预检(OPTIONS)是否成功:如果是非简单请求(比如 CDN 带了自定义 header),会先发一次 OPTIONS;若这步失败,字体请求根本不会发出
@font-face 里 src 加了 crossorigin="anonymous" 却无效
@font-face 规则本身不支持 crossorigin 属性——这个写法会被浏览器忽略。真正起作用的是 CSS 文件本身的加载方式,以及字体资源被发起请求时的上下文。
- 确保加载 CSS 的
标签带crossorigin="anonymous"(不是加在@font-face上) - 不要用
@import引入跨域 CSS:它无法声明crossorigin,服务端即使返回了正确响应头,浏览器也会丢弃样式内容 - 如果 CSS 是内联的(
),那字体请求默认按“非 CORS 模式”发出,Access-Control-Allow-Origin头无效
本地开发用 localhost 加载远程字体总失败
Chrome 和 Edge 把 http://localhost:3000 和 http://127.0.0.1:3000 当作两个不同源,而很多 CDN 对 localhost 的 CORS 白名单没配全,或压根没配。
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
- 检查服务端返回的
Access-Control-Allow-Origin值是不是精确匹配你的页面 origin(比如写成了http://127.0.0.1:3000,但你访问的是http://localhost:3000) - 避免用
*+credentials: 'include'组合:一旦 JS fetch 里带了 cookie,就必须返回具体域名,*会被浏览器拒绝 - 临时验证可改 hosts,把本地域名映射到 127.0.0.1(如
127.0.0.1 dev.your-app.com),然后用这个域名访问,更贴近生产环境
Nginx 配置字体跨域但仍然报错
Nginx 配置容易漏掉两个关键点:MIME 类型识别和预检请求处理。尤其当字体路径带 query 参数(如 ?v=2)时,正则匹配可能失效。
- 确认 location 块匹配到了字体请求:用
location ~* \.(woff2|woff|ttf|eot)$不会匹配/fonts/icon.woff2?v=2,得改成location ~* \.(woff2|woff|ttf|eot)(\?.*)?$ - 检查 MIME 类型:Nginx 默认支持 woff2,但某些旧版本需手动补
types { font/woff2 woff2; } - OPTIONS 预检必须 return 204:只加 header 不 return,Nginx 会继续执行后续配置,导致响应体非空,浏览器判定预检失败
最容易被忽略的是:CDN 缓存了带 Vary: Origin 的响应,但没按 Origin 值做多级缓存键,结果把 A 域的响应返回给了 B 域——看起来配对了,实际每次都在“误伤”。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










