Go hash/maphash Seed 怎样为哈希计算设置独立随机种子

如果你在 Go 里用 hash/maphash 做哈希表、布隆过滤器或自定义集合，Seed 的正确用法可以归纳为一句话：每个数据结构调用一次 maphash.MakeSeed()，需要相同映射的多个 Hash 再复用这一份 Seed。不要把零值 Seed 传给 SetSeed，也不要把 Seed 序列化后交给另一个进程。

官方地址：https://pkg.go.dev/hash/maphash@go1.27.3#Seed

本文只讨论初始化、复用、并发和生命周期，不把 maphash 当作密码学哈希。官方文档明确说明：它面向哈希表和数据结构，输出不是密码学安全摘要。

先把 Seed 看成“选择哈希函数”的进程内句柄

Seed 不是业务配置里的固定数字，而是选择具体哈希函数的随机值。同一个 Seed 给同一个输入，多个 Hash 会得到相同结果；换一个 Seed，结果通常会变化。这样做的价值是让不同哈希表拥有不同的随机化边界，降低攻击者针对固定分布构造冲突的机会。

这里有两个容易混淆的零值：

• 零值 maphash.Hash 是可用的。第一次写入、求和或读取 Seed 时，它会为自己选择随机 Seed。
• 零值 maphash.Seed 没有初始化，不能直接传给 Hash.SetSeed。

为每个哈希表创建独立 Seed

把 Seed 放在数据结构实例里，而不是做成全局共享的固定常量。以一个简单的字符串集合为例，集合内部的桶选择、元素哈希和查找必须使用同一个 Seed。

package main

import "hash/maphash"

// StringSet 保存集合自己的随机化边界；不同实例不共享 Seed。
type StringSet struct {
	seed maphash.Seed
	data map[uint64]string
}

// NewStringSet 调用 MakeSeed，避免把未初始化的零 Seed 传给 Hash。
func NewStringSet() *StringSet {
	return &StringSet{
		seed: maphash.MakeSeed(),
		data: make(map[uint64]string),
	}
}

// Add 使用集合自己的 Seed 计算桶键；实际项目还要处理哈希冲突。
func (s *StringSet) Add(value string) {
	key := maphash.String(s.seed, value)
	s.data[key] = value
}

示例中的 map[uint64]string 只是说明 Seed 的归属，真实集合还要处理不同输入落到同一哈希值的情况。重要的是插入和查询必须引用同一个集合 Seed。

让多个 Hash 复用同一 Seed

单值场景可以直接使用 maphash.String(seed, value) 或 maphash.Bytes(seed, data)。需要增量写入时，为每个 Hash 调用 SetSeed。这样既能让 Hash 独立保存输入状态，又能让它们使用同一套哈希函数。

package main

import (
	"fmt"
	"hash/maphash"
)

func main() {
	seed := maphash.MakeSeed()
	var left, right maphash.Hash

	// 每个 Hash 独立保存字节状态，但共享同一份进程内 Seed。
	left.SetSeed(seed)
	right.SetSeed(seed)
	left.WriteString("account:42")
	right.WriteString("account:42")

	// 相同 Seed 与相同输入得到相同哈希值；不要跨进程保存这个值作稳定 ID。
	fmt.Println(left.Sum64() == right.Sum64())
}

并发时共享 Seed，不共享 Hash

官方文档给出的并发边界很清楚：Hash 不能被多个 goroutine 同时使用，而 Seed 可以安全地复用。因此并发计算同一种哈希时，每个 goroutine 创建自己的 Hash，再设置同一份 Seed。

func hashInWorker(seed maphash.Seed, value string) uint64 {
	var h maphash.Hash
	// worker 只拥有自己的 Hash；Seed 是只读的进程内值，可以复用。
	h.SetSeed(seed)
	if _, err := h.WriteString(value); err != nil {
		// Hash 写入字符串通常不会失败，这里保留错误分支以便替换为其他 Writer。
		return 0
	}
	return h.Sum64()
}

不要把一个已经写入数据的 *maphash.Hash 放进全局变量，然后让多个 goroutine 共同调用。需要共享映射关系时，传递 Seed；需要共享输入状态时，重新设计数据流并为每个执行单元保留独立 Hash。

零 Seed、跨进程和密码学用途都要避开

如果业务需要跨进程稳定键，应选择明确规定输出稳定性的编码或密码学方案；如果只是进程内分桶、集合查找或布隆过滤器，使用独立 Seed 即可。不要为了“固定结果”把 Seed 当作配置文件字段。

常见问题

零值 Hash 还需要手动 MakeSeed 吗？

不需要。零值 Hash 可以直接使用；只有需要控制多个 Hash 使用同一 Seed 时，才显式调用 MakeSeed 和 SetSeed。

能不能把 Seed 存进数据库？

不建议，也不能把它当作跨进程可恢复的序列化值。Seed 的语义是单进程本地值。

maphash.String 的结果能当密码吗？

不能。它服务于数据结构的哈希分布，不是密码学安全哈希；密码摘要和签名应使用 crypto 包中对应的算法。

小结

记住三条规则：每个数据结构用 MakeSeed() 建立自己的 Seed；多个 Hash 复用 Seed、各自保存状态；Seed 只在当前进程有效，不能用于跨进程稳定结果，也不能替代密码学哈希。