Go hash/maphash.MakeHash 怎样生成进程内哈希种子

先说结论：hash/maphash 并没有导出 MakeHash。如果你的目标是“生成一个进程内可复用的哈希种子”，正确入口是 maphash.MakeSeed()；如果需要一个带状态的哈希器，则声明 maphash.Hash，再用 SetSeed 配置它。

官方文档：https://pkg.go.dev/hash/maphash

这个名称误区很常见：Seed 决定具体哈希函数，Hash 保存当前输入状态，两者不是同一个对象。下面按“纠正名称—配置对象—处理边界”的顺序拆开。

先纠正 API：MakeHash 不存在，正确入口是 MakeSeed

在 hash/maphash 中，MakeSeed 创建一个随机的进程内种子；Hash 是实际接收字节序列并产生 64 位结果的对象。不要为了迁就旧代码，把不存在的 MakeHash 当作别名补出来。

package main

import (
	"fmt"
	"hash/maphash"
)

func main() {
	// MakeHash 不是 maphash 的导出函数；MakeSeed 才是创建种子的入口。
	seed := maphash.MakeSeed()

	var h maphash.Hash
	// SetSeed 让这个 Hash 使用指定 Seed，Seed 只在当前进程内有效。
	h.SetSeed(seed)
	h.WriteString("order-1001")

	// Sum64 返回当前输入对应的无符号 64 位哈希值。
	fmt.Printf("%d\\n", h.Sum64())
}

这里的 Seed 是“选择哪一个具体哈希函数”的值，Hash 则保存已经写入的内容。调用 Reset 会清掉输入状态，但不会改变种子。

创建 Seed 后，怎样让多个 Hash 使用同一套规则

同一个数据结构通常应拥有自己的 Seed。要让多个 Hash 对相同输入得到相同结果，可以把同一个 Seed 交给每个 Hash 的 SetSeed；不同 Seed 则通常会得到不同的哈希值。

package main

import (
	"fmt"
	"hash/maphash"
)

func main() {
	// 一个数据结构持有一份进程内 Seed，避免把种子当作外部配置持久化。
	seed := maphash.MakeSeed()

	var left, right maphash.Hash
	// 两个 Hash 独立保存输入状态，但使用同一 Seed。
	left.SetSeed(seed)
	right.SetSeed(seed)
	left.WriteString("user:42")
	right.WriteString("user:42")

	// 相同 Seed 与相同输入会得到相同结果，便于分片或定位同一桶。
	fmt.Println(left.Sum64() == right.Sum64())
}

若只需要一次性计算字符串或字节切片，可以直接调用 maphash.String(seed, value) 或 maphash.Bytes(seed, data)。这两个函数等价于创建 Hash、设置 Seed、写入输入再取 Sum64，但表达更短。

String、Bytes 和 Hash：按输入形态选择

连续写入时，输入的字节序列才是结果依据。把同一字段拆成多次 Write，只要拼接后的字节序列相同，结果就与一次性写入一致；但不要把同一个 Hash 当作全局可并发对象。

Seed 与 Hash 的进程内复用边界

Seed 可以安全地在多个 goroutine 之间共享，但 Hash 本身不支持多个 goroutine 并发使用。并发场景应让每个 goroutine 拥有自己的 Hash，再设置同一份 Seed：

package main

import "hash/maphash"

type KeyHasher struct {
	seed maphash.Seed
}

func (h KeyHasher) Sum(key string) uint64 {
	var hasher maphash.Hash
	// 每次调用使用独立 Hash，避免多个 goroutine 争用同一份可变状态。
	hasher.SetSeed(h.seed)
	// WriteString 追加待计算内容；Hash 的写入错误不会影响此处的返回路径。
	_, _ = hasher.WriteString(key)
	return hasher.Sum64()
}

另一条边界是进程生命周期：Seed 不能序列化，也不能在另一个进程中还原。它适合进程内哈希表、Bloom Filter 或分片定位，不适合把哈希结果当成跨服务协议字段。

常见误用：把 maphash 当成密码学哈希

maphash 的目标是让字符串或字节序列较均匀地映射到无符号 64 位整数，并不提供密码学安全性。密码、签名、完整性校验或需要跨系统复现的摘要，应根据场景选择 crypto/sha256、crypto/sha512 等密码学哈希，而不是保存 Seed 来强行复现。

排查“找不到 MakeHash”时，可以按这张清单处理：

• 需要种子：调用 maphash.MakeSeed()。
• 需要可写入的状态对象：声明 maphash.Hash。
• 需要固定同一进程内的规则：对每个 Hash 调用 SetSeed(seed)。
• 需要单次字符串或字节计算：使用 String 或 Bytes。
• 需要并发：共享 Seed，分配独立 Hash。
• 需要跨进程、密码学或稳定协议摘要：不要使用 maphash。

相关问题

MakeSeed 生成的 Seed 能写进配置文件吗？

不建议。官方语义是 Seed 只属于单个进程，不能序列化或在另一个进程中重建。配置文件中应保存业务配置，而不是把 maphash Seed 当作跨进程密钥。

多个 Hash 使用同一 Seed 会互相覆盖吗？

不会。Seed 是可复用的规则值，Hash 才保存各自的输入状态；只要每个 Hash 实例独立，就不会因为共享 Seed 而互相覆盖。

为什么不能用 maphash 生成密码摘要？

因为 maphash 不是密码学安全哈希，且结果只有面向数据结构分布的语义。密码、签名和完整性校验应使用密码学哈希或专门的密码协议。