You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

NextJS应用部署至Netlify构建失败:字体模块解析异常

NextJS本地字体Netlify构建失败解决方案

问题出在字体文件的路径配置上:你使用的../../public/fonts/xxx相对路径在本地开发环境中可以正常解析,但Netlify构建时,NextJS的编译打包逻辑会改变资源的解析路径,导致无法找到字体模块。

解决步骤:

  • 修改localFont的src路径,直接使用从public目录根开始的绝对路径(以/开头),localFont会自动从项目根目录的public文件夹下查找资源:
const glacialIndifference = localFont({
  src: [
    {
      path: "/fonts/GlacialIndifference-Regular.otf",
      weight: "400",
      style: "normal",
    },
    {
      path: "/fonts/GlacialIndifference-Italic.otf",
      weight: "400",
      style: "italic",
    },
    {
      path: "/fonts/GlacialIndifference-Bold.otf",
      weight: "700",
      style: "normal",
    },
  ],
  variable: "--font-glacial",
});

额外注意事项:

  • 确认public/fonts目录及字体文件存在,且文件名大小写与代码完全一致(Netlify文件系统区分大小写,本地环境可能不区分,这也是常见的构建失败原因)。

内容的提问来源于stack exchange,提问作者lukas23

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.13 00:22:38