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
相关产品推荐
相关产品推荐

