Go 1.22 用 len 统计中文长度少一半 utf8 的 RuneCount 怎么换

用户中心改了昵称规则,2 到 16 个字符。上线当天客服转来截图,三个汉字的昵称被前端提示超长。我第一反应是前端把字节数当长度了,抓包看请求体,后端返回的校验信息确实是长度超限,问题在 Go 这边。

代码写的是 if len(name) < 2 || len(name) > 16。Go 的 len 对 string 返回字节数,一个汉字在 UTF-8 里占 3 字节,三个字就是 9,六个字直接 18,超过 16 被拒。英文用户完全正常,所以测试一直没发现。

改成 utf8.RuneCountInString 之后,汉字按个数算对了,emoji 又出问题。一个带肤色的手势 emoji 由多个码点组成,算出来是 4,用户觉得只是一个表情。业务上要不要把组合字符算一个,这个得先定清楚,不能只看函数名。

另一个更危险的地方是截断,列表页显示前 16 个字符用了 s[:16],正好切在汉字中间,产生无效字节。JSON 序列化直接报 invalid UTF-8,整页 500。改成先转 []rune 再截,或者用 range 逐字符拼接。

数据库这层也顺手对了一遍,MySQL 的 varchar(16) 在 utf8mb4 下按字符算,和 RuneCount 基本一致,但排序规则里的 emoji 仍然占一个字符,前后端三处口径必须统一写进接口文档。

前端那侧也补了计数,用 Array.from 取码点数,和 Go 的 RuneCount 对齐,但两边都不处理组合字符,复杂的 emoji 仍然会显示不一致。产品最后拍板,昵称里禁止使用组合 emoji,规则写在校验接口的返回码里。这条规则上线后客诉少了很多,比在代码里猜字符宽度省事。文档里列了几个反例,测试直接照着写用例。规则写进接口文档之后,两端的实现才算对齐。

确认口径:三个汉字通过,十七个汉字被拒,混合中英文和 emoji 的一万条随机样本没有一条乱码;截断逻辑跑单测,输出始终是合法 UTF-8。

n := utf8.RuneCountInString(name)
if n < 2 || n > 16 {
    return fmt.Errorf("name length %d", n)
}

您可以还会对下面的文章感兴趣: