Go text/template：JSON父节点不存在时如何实现回退机制？

问题场景 #

你的系统通常接收如下JSON输入：

{ "foods": { "plants": { "fruit": "apple" } } }

但需要处理plants节点不存在或为null的情况，比如：

{ "foods": { "plants": null } }

或

{ "foods": { "fungi": { "mushrooms": "button" } } }

直接用{{ if .foods.plants.fruit }}stuff...{{ end }}这类模板语句时，会触发<.foods.plants.fruit>: map has no entry for key "plants"或<.foods.plants.fruit>: nil pointer evaluating interface {}.fruit错误，导致模板执行终止。

可行方案 #

完全可以实现需求，以下是两种常用解决思路：

1. 原生模板语法：嵌套条件判断 #

利用Go模板的if语句逐层检查父节点的存在性与非空状态，避免直接访问不存在的节点。同时在判断链中加入备选路径的检查。

示例模板：

{{- /* 优先取 plants.fruit，不存在则取 fungi.mushrooms */ -}}
{{- if and .foods.plants (ne .foods.plants nil) }}
  {{- if .foods.plants.fruit }}
    选中食材：{{ .foods.plants.fruit }}
  {{- end }}
{{- else if and .foods.fungi (ne .foods.fungi nil) }}
  {{- if .foods.fungi.mushrooms }}
    选中食材：{{ .foods.fungi.mushrooms }}
  {{- end }}
{{- end }}

说明：and .foods.plants (ne .foods.plants nil)用于同时判断节点存在且非空（因为JSON的null解析到Go中是nil接口值）。

2. 自定义模板函数：封装路径检查逻辑 #

如果需要处理的嵌套路径较多，自定义模板函数可以让模板更简洁。注册一个函数，接收多个路径字符串，依次尝试解析路径，返回第一个有效的值。

示例Go代码（注册函数）：

package main

import (
	"encoding/json"
	"html/template"
	"os"
	"strings"
)

func getWithFallback(data map[string]interface{}, paths ...string) interface{} {
	for _, path := range paths {
		parts := strings.Split(path, ".")
		current := data
		valid := true
		for _, part := range parts {
			val, ok := current[part]
			if !ok || val == nil {
				valid = false
				break
			}
			// 尝试转换为map，处理嵌套结构
			if m, ok := val.(map[string]interface{}); ok {
				current = m
			} else {
				// 到达叶子节点，返回值
				return val
			}
		}
		// 如果路径全是map，返回最后一层的map（如果需要叶子节点则调整逻辑）
		if valid {
			return current
		}
	}
	return nil
}

func main() {
	// 示例JSON数据（plants为null的情况）
	jsonStr := `{"foods": {"plants": null, "fungi": {"mushrooms": "button"}}}`
	var data map[string]interface{}
	json.Unmarshal([]byte(jsonStr), &data)

	// 注册自定义函数
	tmpl := template.Must(template.New("food").Funcs(template.FuncMap{
		"getWithFallback": getWithFallback,
	}).Parse(`
选中食材：{{ getWithFallback . "foods.plants.fruit" "foods.fungi.mushrooms" }}
`))

	tmpl.Execute(os.Stdout, data)
}

执行后会输出：选中食材：button

说明：自定义函数可以根据实际需求调整，比如支持更复杂的类型（如切片），或者返回默认值而非nil。

内容的提问来源于stack exchange，提问作者Aaron