头像 One
头像 One

更多功能请点顶栏「快捷菜单」

博客 hugo-teek 760 字 4 分钟 -- 次

运行报错

最后更新于:

报错背景

自己再it pc上推送 hugo-teek项目后，测试都是没问题的，可以正常运行网站。

来到work pc上，拉取仓库后，本地运行项目后，报错如下：

image-20251109093538349

 126752@One MINGW64 /d/hugo-teek (master)
 2$ hugo server --source=hugo-teek-site --bind=0.0.0.0 --port=8080 --buildDrafts
 3Watching for changes in D:\hugo-teek\hugo-teek-site\{assets,content,data,static,themes}
 4Watching for config changes in D:\hugo-teek\hugo-teek-site\hugo.toml
 5Start building sites … 
 6hugo v0.148.2-40c3d8233d4b123eff74725e5766fc6272f0a84d+extended+withdeploy windows/amd64 BuildDate=2025-07-27T12:43:24Z VendorInfo=gohugoio
 7
 8ERROR render of "/" failed: "D:\hugo-teek\hugo-teek-site\themes\hugo-teek\layouts\index.html:217:13": execute of template failed: template: index.html:217:13: executing "main" at <partial "site-info-card.html" .>: error calling partial: "D:\hugo-teek\hugo-teek-site\themes\hugo-teek\layouts\partials\site-info-card.html:3:18": execute of template failed: template: _partials/site-info-card.html:3:18: executing "_partials/site-info-card.html" at <len $docAnalysis.fileList>: error calling len: reflect: call of reflect.Value.Type on zero Value
 9Built in 620 ms
10Error: error building site: render: failed to render pages: render of "/" failed: "D:\hugo-teek\hugo-teek-site\themes\hugo-teek\layouts\index.html:217:13": execute of template failed: template: index.html:217:13: executing "main" at <partial "site-info-card.html" .>: error calling partial: "D:\hugo-teek\hugo-teek-site\themes\hugo-teek\layouts\partials\site-info-card.html:3:18": execute of template failed: template: _partials/site-info-card.html:3:18: executing "_partials/site-info-card.html" at <len $docAnalysis.fileList>: error calling len: reflect: call of reflect.Value.Type on zero Value
11
1226752@One MINGW64 /d/hugo-teek (master)

豆包提问

根据错误信息，核心问题是 $docAnalysis 变量未初始化或为 nil，导致访问 $docAnalysis.fileList 时触发空值错误。以下是分步解决方案：

一、定位出错文件

错误来自主题的 partial 模板：

1themes/hugo-teek/layouts/partials/site-info-card.html

二、修复核心：添加空值判断

打开上述文件，找到第3行（出错行），原代码应该类似：

1{{ len $docAnalysis.fileList }}

由于 $docAnalysis 可能未定义或为 nil，直接访问 fileList 会报错。需要添加双重空值判断：

方案1：简单判断（推荐）

1{{ if and $docAnalysis $docAnalysis.fileList }}{{ len $docAnalysis.fileList }}{{ else }}0{{ end }}

方案2：完整兼容写法（更稳妥）

1{{ $fileCount := 0 }}
2{{ if $docAnalysis }}
3  {{ if $docAnalysis.fileList }}
4    {{ $fileCount = len $docAnalysis.fileList }}
5  {{ end }}
6{{ end }}
7{{ $fileCount }}

三、补充：确保 $docAnalysis 正确定义（可选）

如果 $docAnalysis 是你自己定义的变量，需要在使用前确保它被初始化（避免 nil）：

1{{/* 在模板开头添加变量初始化 */}}
2{{ $docAnalysis := .Site.Data.docAnalysis | default (dict "fileList" nil) }}
  • 若 docAnalysis 是数据文件（data/docAnalysis.yaml），会自动加载
  • 若不存在，默认初始化为 {fileList: nil}，避免空指针

四、验证修复

修改后重新启动 Hugo 服务器：

1hugo server --source=hugo-teek-site --bind=0.0.0.0 --port=8080 --buildDrafts

如果没有再出现 reflect: call of reflect.Value.Type on zero Value 错误，说明修复成功。

错误原因总结

Hugo 模板中访问嵌套字段时，必须确保每一层都非空：

  • 原代码直接访问 $docAnalysis.fileList，但 $docAnalysis 可能未定义（nil）
  • len 函数无法接收 nil 值，导致反射错误
  • 通过 and $docAnalysis $docAnalysis.fileList 先判断两层非空，再调用 len 即可避免错误

结论

后面不知道为啥就正常了。。。。🤣🤣🤣

📡
👤 作者: One
🔗 链接: https://onedayxyy.cn/topics/hugo-teek-dev-error
🌐 版权: 本站文章除特别声明外，均采用 CC BY-NC-SA 4.0 协议，转载请注明来自 One Blog！
最新文章

文档导航