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

Hugo生成站点部署异常,求故障排查指导

Hugo部署至Fleek后无法渲染的排查方案
  • 检查Fleek构建配置
    确认Fleek的构建命令为hugo(hugo server仅用于本地开发,生产环境需用hugo生成静态文件)。同时核对构建输出目录是否为public,若你的配置文件中修改过publishDir,需同步更新Fleek的对应设置。

  • 排查配置文件问题

    • baseURL设置:本地开发时可能设为http://localhost:1313/,部署到Fleek后需修改为你的实际域名https://mute-violet-7769.on.fleek.co/,否则资源路径错误会导致页面样式、内容加载失败。
    • 主题完整性:若使用第三方主题(如你的仓库中的LoveIt),需确认主题文件已完整提交至仓库。如果是通过Git子模块引入的主题,要确保子模块已初始化并提交,Fleek不会自动拉取未提交的子模块内容。
  • 验证仓库提交内容
    确保content目录的文章、static目录的静态资源等核心文件都已提交至仓库。注意:通常不建议提交public目录,该目录应由Fleek构建时自动生成。

  • 查看Fleek构建日志
    登录Fleek后台进入你的项目,查看构建过程的日志信息,日志会明确显示构建时的错误(如主题缺失、命令执行失败、配置语法错误等),这是快速定位问题的关键。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.02 21:15:56