Go中并发安全模板问题：template.New为何触发map并发panic？

原因分析 #

从panic回溯和代码细节来看，问题并非template.New本身的并发安全性问题，而是出在共享的FuncMap被并发修改与遍历：

• 你的代码中调用.Funcs(templateFunctions)时，text/template内部会执行addValueFuncs函数，遍历传入的templateFunctions map。
• 如果templateFunctions是全局共享的变量，且有其他协程在并发对其执行增删改操作，就会触发Go map的固有限制——并发迭代和写入会直接导致panic。

解决方法 #

针对不同场景，可选择以下方案：

方案1：让FuncMap保持只读（推荐） #

在程序启动阶段一次性初始化templateFunctions，之后不再对其做任何修改。Go的map在只读场景下是并发安全的，多个协程同时遍历不会产生冲突。

方案2：传递FuncMap的副本 #

每次调用.Funcs()时，创建templateFunctions的副本，避免多个协程共享同一个map：

// 在初始化模板前复制FuncMap
funcMapCopy := make(template.FuncMap, len(templateFunctions))
for k, v := range templateFunctions {
    funcMapCopy[k] = v
}

// 使用副本初始化模板
t, err = template.New(filepath.Base(name)).Funcs(funcMapCopy).Parse(string(asset))

方案3：用锁保护FuncMap的访问 #

如果必须动态修改templateFunctions，使用sync.Mutex对所有读写操作加锁：

// 定义全局互斥锁
var funcMapMutex sync.Mutex

// 读取FuncMap时加锁并复制
funcMapMutex.Lock()
funcMapCopy := make(template.FuncMap, len(templateFunctions))
for k, v := range templateFunctions {
    funcMapCopy[k] = v
}
funcMapMutex.Unlock()

// 使用副本初始化模板
t, err = template.New(filepath.Base(name)).Funcs(funcMapCopy).Parse(string(asset))

// 修改templateFunctions时也必须加锁
funcMapMutex.Lock()
templateFunctions["yourNewFunc"] = yourNewFunc
funcMapMutex.Unlock()

内容的提问来源于stack exchange，提问作者Igor Chubin