Go maphash.Hash.SetSeed 怎样让多个哈希器使用同一随机种子

如果多个 Go 哈希器要对同一批输入使用同一个哈希函数，做法是先调用 maphash.MakeSeed() 得到进程内的 Seed，再分别对每个 maphash.Hash 调用 SetSeed(seed)。这样每个哈希器仍然是独立对象，但在相同 Seed 和相同字节序列下会得到一致的哈希结果。

关键点是共享 Seed，不要共享同一个正在写入的 Hash。SetSeed 还会丢弃调用前已经写入的字节；Seed 只在当前进程内有意义，也不是密码学密钥。

官方资料：https://pkg.go.dev/hash/maphash#Hash.SetSeed

SetSeed 到底改变了什么

maphash.Hash 计算的是带 Seed 的 64 位非加密哈希。Seed 可以理解为“这一组哈希器采用哪一个具体哈希函数”的选择器，而不是要拼接到输入前面的普通字节。零值 Hash 可以直接使用；如果需要让多个实例采用同一个选择器，就把一个有效 Seed 传给它们的 SetSeed。

Seed 可以来自 MakeSeed，也可以从另一个已经初始化过的 Hash 调用 Seed() 取得。不能把零值 maphash.Seed{} 当作有效 Seed 传入，也不能把 Seed 当作可保存到配置文件、再在另一个进程恢复的稳定密钥。

用同一个 Seed 配置多个 Hash

下面的示例创建一个 Seed，再给两个独立的 Hash 配置它。两者接收完全相同的字符串后，Sum64 的结果会一致；这说明的是哈希函数选择一致，不代表哈希结果具备密码学安全性。

package main

import (
	"fmt"
	"hash/maphash"
)

func main() {
	// 一个 Seed 只在当前进程内选择具体的 maphash 函数。
	seed := maphash.MakeSeed()

	var left, right maphash.Hash
	// 两个 Hash 仍然独立，分别设置为同一个 Seed。
	left.SetSeed(seed)
	right.SetSeed(seed)

	input := "order:20261027"
	// 写入相同字节序列，才能比较两个哈希器的结果。
	_, _ = left.WriteString(input)
	_, _ = right.WriteString(input)

	fmt.Println(left.Sum64() == right.Sum64())
}

实际项目中，如果只是对一个字符串做一次计算，也可以使用 maphash.String(seed, input) 这样的便捷函数。需要增量写入、读取 Seed 或实现 hash.Hash 接口时，再使用显式的 Hash 对象更合适。

并发计算时怎样分配 Hash 实例

官方文档的并发边界很明确：Seed 可以被多个 goroutine 使用，但同一个 Hash 不能被多个 goroutine 同时写入。并发场景应把共享 Seed 当作只读配置，把 Hash 当作每个任务独占的工作状态。

package main

import (
	"fmt"
	"hash/maphash"
	"sync"
)

func hashOne(seed maphash.Seed, text string) uint64 {
	var h maphash.Hash
	// 每个调用创建自己的 Hash，避免多个 goroutine 共享可变状态。
	h.SetSeed(seed)
	_, _ = h.WriteString(text)
	return h.Sum64()
}

func main() {
	seed := maphash.MakeSeed()
	inputs := []string{"tenant:a", "tenant:b"}
	results := make([]uint64, len(inputs))
	var wg sync.WaitGroup
	for i, input := range inputs {
		wg.Add(1)
		go func(index int, value string) {
			defer wg.Done() // 无论计算是否提前返回，都要释放等待计数。
			results[index] = hashOne(seed, value)
		}(i, input)
	}
	wg.Wait()
	fmt.Println(results)
}

如果使用共享 Seed 的目的只是让多个分片计算得到同一套映射结果，那么每个分片可以持有一个自己的 Hash，并在初始化时调用一次 SetSeed。不要在计算过程中反复调用 SetSeed 来“刷新”状态，因为该调用会丢弃此前写入的内容。

SetSeed 的四个边界

还要注意，Seed 相同只是哈希函数选择相同；输入字节序列不同，结果当然可能不同。对于字符串、字节切片和结构化值，先确定所有参与计算的字段顺序和编码方式，再比较哈希结果。

常见问题

为什么两个 Hash 没有调用 SetSeed，结果也可能看起来稳定？

零值 Hash 会在首次使用时自行选择 Seed，但不同 Hash 不保证选择同一个 Seed。需要跨实例保持一致时，必须显式共享 Seed。

可以把一个 Hash.Seed 传给很多 goroutine 吗？

可以把 Seed 作为参数传递给多个 goroutine；每个 goroutine 应该创建或持有自己的 Hash。不能把同一个 Hash 当成并发写入的共享对象。

SetSeed 为什么让之前的 Sum64 结果变化了？

SetSeed 不只是修改一个配置字段，它会丢弃 Hash 中已经写入的字节并切换 Seed。调用后需要重新写入完整输入，再读取新的结果。

归纳起来，SetSeed 解决的是“多个 Hash 实例使用同一进程内哈希函数”的一致性问题：Seed 共享，Hash 独占；设置 Seed 要早于写入；不要把它当作跨进程持久化密钥或密码学摘要。