问题：

目前，在使用 json.Unmarshal()(或 json.NewDecoder().Decode())解析 JSON 时，如果一个值被解析到实现了 encoding.TextUnmarshaler(或 json.Unmarshaler)的结构体字段中，而 .UnmarshalText() 返回错误，这个错误将从整个 json.Unmarshal 函数中不变地返回：
https://go.dev/play/p/G5ag-Cq2OMf

type CustomType string

func (p *CustomType) UnmarshalText(_ []byte) error {
	return errors.New("test err")
}

type A struct {
	B B `json:"b"`
}
type B struct {
	Cs []C `json:"cs"`
}
type C struct {
	D CustomType `json:"d"`
}

func main() {
	a := A{}
	err := json.Unmarshal([]byte(`{"b":{"cs":[{"d": "val"}]}}`), &a)
	fmt.Println(err)
	fmt.Printf("%#v\n", err)
}

输出：

test err
&errors.errorString{s:"test err"}

这样一来，当输入较大/包含多个字段(其中一些嵌套)时，调用者无法在输入的 JSON 中定位错误。
与输入 JSON 中的类型与结构体字段类型不兼容时的类似错误进行比较：
https://go.dev/play/p/ZgexFrs-r_c

// same type definitions

func main() {
	a := A{}
	err := json.Unmarshal([]byte(`{"b":{"cs":[{"d": 0}]}}`), &a)
	fmt.Println(err)
	fmt.Printf("%#v\n", err)
}

输出：

json: cannot unmarshal number into Go struct field C.b.cs.d of type main.CustomType
&json.UnmarshalTypeError{Value:"number", Type:(*reflect.rtype)(0x4b5460), Offset:19, Struct:"C", Field:"b.cs.d"}

在这种情况下，返回的错误包含大量有用的信息来定位输入中的问题，特别是包含 JSON 中有问题值的路径的 Field。

建议：

与 json.UnmarshalTypeError 类似，当 json.Unmarshal 从 .UnmarshalText() 或 .UnmarshalJSON() 获得错误时，错误将被 Package 到类似的结构中，例如(当前不存在，建议的错误) &json.UnmarshalerError{Type:(*reflect.rtype)(0x4b5460), Offset:19, Struct:"C", Field:"b.cs.d", Err: &errors.errorString{s:"test err"}}。与 json.UnmarshalTypeError 相比，Value 被移除，因为它可能没有用处(如果需要，可以由字段类型的 unmarshal 方法添加),但保留了原始错误的 Err,以便原始错误仍然可用(或可不可用)。(此外，Field:"b.cs.d" 可以是 Field:"b.cs[0].d" 以更好地在 JSON 列表中定位错误，但为了与 json.UnmarshalTypeError 保持一致，它仍然是相同的，即 Field:"b.cs.d" )

注意

我看到最近有一个非常相似的提案被提交了 - 返回一个更友好的错误，尽管是在不同的场景下(不允许未知字段):#58649
所以也许解决方案可能在某种程度上相似(针对每种情况都有一个特殊的错误类型？),并且可以一起实现。