解决 golang 中输出 (MISSING)

一、现象

用户反馈，golang 的某个服务列表突然打不开了，在本地复现后，发现，原本返回的 json 串，里面突然多了 (MISSING) 这个东东

{
    "description": "哈哈哈123￥%!￥(MISSING)￥##￥￥%!"(MISSING)
}

这样就导致前端渲染 json 失败。

二、原因

调用的是 http 服务，实用 fmt.Fprintf(w, string(bytes)) 输出，追踪到源码里，发现对 % 做了特殊处理，也就是输出的字符串里有 %，那么就在匹配右边是否有对应的输出符，没有就打印上面的输出了。

switch {
case verb == '%': // Percent does not absorb operands and ignores f.wid and f.prec.
	p.buf.writeByte('%')
case !p.goodArgNum:
	p.badArgNum(verb)
case argNum >= len(a): // No argument left over to print for the current verb.
	p.missingArg(verb)
case verb == 'v':
	// Go syntax
	p.fmt.sharpV = p.fmt.sharp
	p.fmt.sharp = false
	// Struct-field syntax
	p.fmt.plusV = p.fmt.plus
	p.fmt.plus = false
	fallthrough
default:
	p.printArg(a[argNum], verb)
	argNum++
}

func (p *pp) missingArg(verb rune) {
	p.buf.writeString(percentBangString)
	p.buf.writeRune(verb)
	p.buf.writeString(missingString)
}

cosnt(
percentBangString = "%!"
missingString     = "(MISSING)"
)

其实也好理解，看下此方法的说明，就了解了

// Printf formats according to a format specifier and writes to standard output.
// It returns the number of bytes written and any write error encountered.
func Printf(format string, a ...any) (n int, err error) {
	return Fprintf(os.Stdout, format, a...)
}

Printf 是根据格式说明符格式化并写入标准输出，由于字符中有 % 且没有对应的说明符，导致格式化失败。

三、解决

由于 % 属于正常的输入，不算做是特殊的字符，为了规避这种现象，后来换成 io.WriteString(w, string(bytes))。

四、参考

1. URL Escaping producing “%A(MISSING)” instead of “%3A”
2. Golang Escape Variables with Printf