Go语言实现短链接生成器教程

本文深入剖析了用Go语言构建高可靠短链接生成器的核心实践，直击常见误区——摒弃冗长且易碰撞的md5/sha256哈希截断方案，转而推荐更高效可控的自增ID转62进制或fnv32a哈希取模映射策略，并强调必须结合数据库唯一约束与带重试机制的原子插入（如ON CONFLICT DO NOTHING）来彻底解决并发冲突；同时详解了动态路由匹配、安全路径解析、反向代理透传配置及跳转头设置等上线必踩坑点，揭示短链接系统的真正难点不在算法，而在端到端链路中每个环节的严谨性与容错设计——读完就能避开90%生产环境404、跳错和缓存失效的陷阱。

短链接哈希用 md5 还是 sha256？

直接说结论：别用 md5，也别用 sha256 —— 它们输出太长，且不解决冲突问题。短链接要的是「短」+「可逆/可查」+「低碰撞」，不是密码学安全强度。

实际做法是：用 base64 编码后的哈希前 6 位（或类似截断），但更稳妥的是走「自增 ID + 自定义进制转换」，比如 62 进制（0-9a-zA-Z）。Go 标准库没有现成的 62 进制转换，得自己写或用 strconv.FormatInt 配合映射表。

• md5 输出 128 位，base64 后约 22 字符，截到 6 位后碰撞概率飙升（尤其在百万量级时）
• sha256 更糟，base64 后约 43 字符，截短等于白算
• 真要哈希，用 fnv.New32a() 这类快哈希，再对结果取模 len(alphabet) 做映射，比硬截更可控

怎么把长 URL 映射成短码并存进数据库？

核心不是“生成”，而是“查重 + 存储 + 返回”。很多人卡在第一次就重复生成相同短码，或者没处理并发写入冲突。

典型错误是：先 SELECT 没命中，再 INSERT，中间被另一个请求插入同一条，导致唯一键冲突。Go 里要用 INSERT ... ON CONFLICT DO NOTHING（PostgreSQL）或 INSERT IGNORE（MySQL），而不是靠应用层判断。

• 字段设计至少要有：id（自增主键）、long_url（带索引）、short_code（唯一索引）
• 生成短码逻辑建议放事务外：先生成候选码 → 尝试插入 → 插入失败就换一个 → 最多重试 5 次，避免死循环
• 别把哈希值直接当 short_code 存，它不可读、难调试；用独立生成的短码，哈希只做内部去重辅助（如存在缓存中）

net/http 路由怎么匹配动态短码路径？

不能写死一堆 /a、/b、/ab12，得用通配路由。Go 的 http.ServeMux 不支持参数提取，必须用第三方路由器（如 gorilla/mux）或手撸解析。

最简方案：用 http.HandleFunc 拦所有 / 开头的路径，然后手动切分 r.URL.Path：

if strings.HasPrefix(r.URL.Path, "/") && len(r.URL.Path) > 1 {
    code := strings.TrimPrefix(r.URL.Path, "/")
    // 校验 code 长度（如 4–8 字符）、字符范围（^[a-zA-Z0-9]+$）
    // 查库，302 跳转
}

• 注意路径里可能带 %2F 或多余斜杠，r.URL.Path 已解码，但需防 ../ 绕过
• 别用 r.URL.Query().Get("code") —— 短链接是路径语义，不是查询参数
• 跳转用 http.Redirect(w, r, longURL, http.StatusFound)，别用 StatusMovedPermanently，后期可能要改目标

为什么本地测试能跑，上线后 404 或跳错？

多半是反向代理（Nginx / Caddy）或云服务（Cloudflare / ALB）没透传原始路径，或者自动去掉了尾部斜杠。

• Nginx 配置里确保 location / { proxy_pass http://backend; } 不带结尾 /，否则会 strip 掉路径前缀
• Cloudflare 默认开启「Auto Minify」和「Rocket Loader」，可能误改 HTML 中的跳转链接，关掉即可
• Go 服务启动时监听地址写成 :8080 没问题，但若前面有代理，r.Host 和 r.URL.Scheme 可能不准，跳转时用绝对 URL 要从 X-Forwarded-Proto 和 X-Forwarded-Host 头读，而不是硬编码 https://

短链接系统最难的从来不是哈希算法，而是「怎么让每个短码都稳定对应唯一长链，且不被中间层吃掉、改写、缓存错」—— 这些地方一漏，用户点开就是 404 或跳到别人家页面。

到这里，我们也就讲完了《Go语言实现短链接生成器教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！