Golang开发一个简单的URL短链服务

发布时间 - 2026-01-12 00:00:00    点击率:
不用自增ID做短码因会暴露业务数据、难以并发预知ID,需解耦;推荐随机+重试或雪花ID派生,Go+SQLite用INSERT ON CONFLICT避免竞态。

为什么不用自增ID做短码

直接用数据库自增 id 转成62进制看似简单,但暴露了业务总量、增长节奏,还容易被遍历撞库。真实场景下,id 是内部标识,短码必须和它解耦。

更关键的是:并发插入时,你没法在写入前预知 id,除非先 INSERT ... RETURNING id(PostgreSQL)或用 LAST_INSERT_ID()(MySQL),但这会增加一次 round-trip,且难以原子化生成“未被占用的短码”。

  • 短码生成必须是无状态、可并行、不依赖 DB 主键分配
  • 推荐用随机 + 冲突重试,或雪花 ID 派生(需注意时间戳部分可能泄露)
  • 线上服务建议加布隆过滤器预判冲突,但小规模服务直接 INSERT ... ON CONFLICT DO NOTHING 更直白

如何用 Go + SQLite 实现基础短链写入

SQLite 足够支撑日均百万以下请求,且免运维。重点不是选型,而是怎么让 INSERT 不因短码重复失败。

核心逻辑:生成候选短码 → 尝试插入 → 若已存在则重试(带上限)。不要用 SELECT 判断是否存在,那是竞态源头。

func (s *Service) CreateShortURL(longURL string) (string, error) {
    const maxRetries = 5
    for i := 0; i < maxRetries; i++ {
        code := randString(6) // 例如:aB3xK9
        _, err := s.db.Exec("INSERT INTO urls (code, long_url, created_at) VALUES (?, ?, ?)",
            code, longURL, time.Now().UTC())
        if err == nil {
            return code, nil
        }
        if sqlite.ErrConstraint(err) && strings.Contains(err.Error(), "UNIQUE") {
            continue // 短码冲突,重试
        }
        return "", err
    }
    return "", errors.New("failed to generate unique short code after retries")
}
  • randString(6) 建议用 math/rand + 字符集(a-z, A-Z, 0-9),避免 0/O/l/I 等易混淆字符
  • SQLite 的 UNIQUE 约束报错信息含 "UNIQUE constraint failed",不能只靠 sqlite.ErrConstraint
  • 生产环境应加 context.Context 控制超时,避免卡死在重试循环里

HTTP 路由怎么处理 302 跳转与 /api/shorten 分离

短链访问路径如 /abc123 必须 302 跳转,而创建接口是 POST /api/shorten。二者不能共用一个 handler,否则 GET /api/shorten 会误触发跳转。

http.ServeMuxgorilla/mux 都行,关键是路由顺序和通配符控制:

func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("POST /api/shorten", handleShorten)
    mux.HandleFunc("GET /", handleRoot) // 可选首页
    mux.HandleFunc("GET /{code}", handleRedirect) // 注意:标准 net/http 不支持 {code},需用 gorilla/mux 或 chi

    // 若坚持用 net/http,可:
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        if r.Method == "POST" && r.URL.Path == "/api/shorten" {
            handleShorten(w, r)
            return
        }
        if r.Method == "GET" && len(r.URL.Path) > 1 {
            code := strings.TrimPrefix(r.URL.Path, "/")
            if len(code) >= 4 && len(code) <= 8 && isAlnum(code) {
                handleRedirect(w, r, code)
                return
            }
        }
        http.NotFound(w, r)
    })
}
  • handleRedirect 中务必校验 code 长度和字符范围,防止路径遍历或 SQL 注入(即使用了参数化查询,也要防无效请求放大)
  • 跳转前查 DB,命中则 http.Redirect(w, r, longURL, http.StatusFound);未命中返回 404
  • 别忘了设置 Cache-Control: no-cache,避免 CDN 缓存错误跳转

Redis 缓存怎么避免缓存穿透和雪崩

短链跳转是典型读多写少场景,加 Redis 能扛住突发流量,但两个坑必须填:

  • 缓存穿透:恶意请求大量不存在的 code,每次都打到 DB。解决方案:对空结果也缓存(如 SET short:xyz "" EX 60),值为空字符串,过期时间设短(60s)
  • 缓存雪崩:所有 key 同一时刻过期,DB 瞬间被打满。解决方案:写入时加随机偏移,比如 EX 3600 + rand.Intn(600)

Go 中用 github.com/go-redis/redis/v9 时,注意 GET 返回 redis.Nil 表示 key 不存在,不是 error:

val, err := rdb.Get(ctx, "short:"+code).Result()
if err == redis.Nil {
    // 查 DB,若存在则 SET,若不存在则 SET 空值
} else if err != nil {
    // 真实错误
} else {
    // 命中缓存,跳转
}

短码生成、存储、跳转三个环节里,最易被忽略的是「跳转响应头」:必须用 http.StatusFound(302),不是 http.StatusMovedPermanently(301),否则浏览器会强缓存跳转目标,改链接后用户刷不出来。


# mysql  # go  # golang  # ai  # 路由  # golang开发  # 为什么  # red  # sql  # select  # Error  # math  # 字符串  # 循环  # 接口  # nil  # 并发  # github  # sqlite  # redis  # postgresql  # 数据库  # http  # 跳转  # 重试  # 的是  # 遍历  # 不存在  # 化生  # 加布  # 那是  # 也要  # 用了 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: javascript中的try catch异常捕获机制用法分析  Laravel Octane如何提升性能_使用Laravel Octane加速你的应用  个人网站制作流程图片大全,个人网站如何注销?  Laravel如何实现文件上传和存储?(本地与S3配置)  Laravel怎么使用Blade模板引擎_Laravel模板继承与Component组件复用【手册】  Laravel如何生成和使用数据填充?(Seeder和Factory示例)  html5如何实现懒加载图片_ intersectionobserver api用法【教程】  如何在阿里云ECS服务器部署织梦CMS网站?  Laravel安装步骤详细教程_Laravel环境搭建指南  如何用已有域名快速搭建网站?  昵图网官方站入口 昵图网素材图库官网入口  标题:Vue + Vuex 项目中正确使用 JWT 进行身份认证的实践指南  Laravel如何安装使用Debugbar工具栏_Laravel性能调试与SQL监控插件【步骤】  Laravel如何实现事件和监听器?(Event & Listener实战)  Firefox Developer Edition开发者版本入口  laravel怎么在请求结束后执行任务(Terminable Middleware)_laravel Terminable Middleware请求结束任务执行方法  iOS中将个别页面强制横屏其他页面竖屏  Laravel如何保护应用免受CSRF攻击?(原理和示例)  详解Android中Activity的四大启动模式实验简述  如何在 Pandas 中基于一列条件计算另一列的分组均值  详解jQuery中基本的动画方法  Claude怎样写结构化提示词_Claude结构化提示词写法【教程】  Laravel如何处理和验证JSON类型的数据库字段  教你用AI将一段旋律扩展成一首完整的曲子  Laravel怎么生成URL_Laravel路由命名与URL生成函数详解  微信小程序 canvas开发实例及注意事项  网站制作免费,什么网站能看正片电影?  Laravel如何正确地在控制器和模型之间分配逻辑_Laravel代码职责分离与架构建议  香港网站服务器数量如何影响SEO优化效果?  Laravel模型关联查询教程_Laravel Eloquent一对多关联写法  千问怎样用提示词获取健康建议_千问健康类提示词注意事项【指南】  零基础网站服务器架设实战:轻量应用与域名解析配置指南  电视网站制作tvbox接口,云海电视怎样自定义添加电视源?  Linux网络带宽限制_tc配置实践解析【教程】  香港代理服务器配置指南:高匿IP选择、跨境加速与SEO优化技巧  php结合redis实现高并发下的抢购、秒杀功能的实例  jQuery中的100个技巧汇总  Win11怎样安装网易有道词典_Win11安装词典教程【步骤】  Gemini手机端怎么发图片_Gemini手机端发图方法【步骤】  Laravel中间件起什么作用_Laravel Middleware请求生命周期与自定义详解  如何用AWS免费套餐快速搭建高效网站?  Laravel任务队列怎么用_Laravel Queues异步处理任务提升应用性能  Android使用GridView实现日历的简单功能  什么是JavaScript解构赋值_解构赋值有哪些实用技巧  实例解析angularjs的filter过滤器  移动端脚本框架Hammer.js  如何用好域名打造高点击率的自主建站?  如何在 Go 中优雅地映射具有动态字段的 JSON 对象到结构体  详解jQuery中的事件  Laravel如何使用Passport实现OAuth2?(完整配置步骤)