Golang搭建简易投票系统教程

本文手把手教你用 Go 原生 net/http 从零构建一个轻量、安全、生产就绪的简易投票系统：不依赖任何 Web 框架，用内存 map + sync.RWMutex 高效管理选项与计票状态，通过带过期时间的 base64 token（而非脆弱的 IP/User-Agent）实现可靠去重，导出 CSV 时精准插入 UTF-8 BOM 解决中文在 Excel 中乱码的“坑”，并强制每个 handler 使用 defer-recover 捕获 panic、禁用 debug.PrintStack、分离日志与响应体——直击新手易犯的部署陷阱，如 token 内存泄漏、非法输入导致服务崩溃、敏感信息泄露等，真正践行“先跑通再扩展”的工程思维。

用 net/http 快速启动投票服务，别碰框架先

不需要 gin 或 echo，原生 net/http 足够撑起一个带增删查的投票接口。重点是把路由和状态分离清楚：投票选项存在内存 map 里（开发阶段），用 sync.RWMutex 保护并发读写。别一上来就连数据库——90% 的调试问题出在过早引入外部依赖。

• http.HandleFunc("/vote", handleVote) 接收 POST，解析 JSON 中的 option_id
• http.HandleFunc("/results", handleResults) 返回当前各选项计数，用 json.NewEncoder(w).Encode()
• 所有写操作（如新增选项、投票）必须加 mutex.Lock()，读操作用 RUnlock()

投票去重靠客户端 IP + User-Agent 不可靠，改用简单 token

只靠 r.RemoteAddr 或 r.Header.Get("User-Agent") 做去重，几行代码就能绕过。实际只需在首次访问根路径时生成一个带过期时间的 base64 token，存进 HTTP Cookie，并在 handleVote 中校验它是否已投过票。

• 用 crypto/rand.Read() 生成 12 字节随机数，再 base64.StdEncoding.EncodeToString()
• Cookie 设置 MaxAge: 3600（1 小时），HttpOnly: true，避免 JS 篡改
• 服务端维护一个 map[string]bool 记录已投 token，key 是 token 值，不是 IP

统计结果导出为 CSV 时注意中文乱码和 Excel 兼容性

直接用 encoding/csv 写中文字段，Excel 打开会显示乱码。根本原因是 Windows 默认用 GBK 解析 CSV，而 Go 输出的是 UTF-8。必须在文件开头插入 UTF-8 BOM（\uFEFF）。

func exportCSV(w http.ResponseWriter, results map[string]int) {
	w.Header().Set("Content-Type", "text/csv; charset=utf-8")
	w.Header().Set("Content-Disposition", `attachment; filename="votes.csv"`)

	writer := csv.NewWriter(w)
	defer writer.Flush()

	// 写入 BOM
	w.Write([]byte("\uFEFF"))

	writer.Write([]string{"选项", "票数"})
	for option, count := range results {
		writer.Write([]string{option, strconv.Itoa(count)})
	}
}

部署前必须关掉 debug.PrintStack() 和未捕获 panic

本地测试时习惯用 log.Fatal(err) 或裸奔 panic，上线后一次非法 JSON 就会让整个服务 crash。HTTP handler 必须包一层 defer-recover，且禁止打印完整堆栈到响应体——这等于把内存布局暴露给攻击者。

• 在每个 handler 开头加 defer func() { if r := recover(); r != nil { http.Error(w, "Internal error", http.StatusInternalServerError) } }()
• 所有 json.Unmarshal 后必须检查 err，错误时返回 http.StatusBadRequest，不调 fmt.Println
• 日志用 log.Printf("[vote] %v", err) 写到文件或 stdout，别回传给前端

真实环境里，最常被忽略的是 token 过期后没清内存里的记录，导致 map 持续膨胀；还有就是 CSV 导出没加 BOM，运营同学每天手动用记事本转码。

好了，本文到此结束，带大家了解了《Golang搭建简易投票系统教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！