短链逻辑应绕过mvc生命周期:跳转终结点下沉至app/init.go中用app.use()注册中间件,匹配/s/路径;生成接口保留在shorturlcontroller但仅校验url与调用service;数据库操作放app/models/short_url.go;base62编码需混淆id(如id ^ secretseed)并固定字符集;跳转必须用302响应手动构造,禁用缓存;mysql和redis连接池参数须显式配置。

Revel 项目结构里该往哪放短链逻辑
短链接服务在 Revel 中不能塞进 app/controllers 里当普通页面处理,否则每次跳转都要走完整 MVC 生命周期,延迟直接拉高 5–10ms。正确做法是把跳转终结点下沉到 app/init.go 的 app.Init() 阶段之后、路由注册之前,用 app.Use() 注册一个极简中间件,路径匹配以 /s/ 开头的请求(如 /s/abc123),绕过所有控制器和模板渲染。
生成接口可以保留在 ShortUrlController 里,但必须只做两件事:校验长 URL 格式、调用后端 service 层写库并返回短码。不要在 controller 里做编码、缓存填充或重定向。
- 数据库操作统一放在
app/models/short_url.go,含Create()、FindByCode()两个核心方法 - 短码生成逻辑抽成独立包,比如
utils/base62.go,避免和 HTTP 层耦合 - Redis 缓存封装为
cache/redis_client.go,提供GetLongURL(code)和SetLongURL(code, url, ttl)
Base62 编码自增 ID 时为什么不能直接用 id
Revel 默认用 MySQL 自增主键,但直接把 id 转 Base62 暴露出去等于泄露数据增长节奏——攻击者访问 /s/a、/s/b、/s/c 就能枚举全量短链。必须加一层混淆:先用 Snowflake 或随机偏移(如 id ^ 0x5a5a5a5a)打乱顺序,再进 Base62。
示例中常见错误是写成 encodeBase62(id),正确应为 encodeBase62(id ^ secretSeed),其中 secretSeed 是配置项,不硬编码在源码里。
- 字符集必须固定为
"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",大小写顺序不能错,否则解码失败 - 编码函数要处理
id == 0边界情况,避免空字符串 - 不要用
fmt.Sprintf("%x", id)再转 Base62,性能差且不可控
跳转响应为什么必须用 302 而不是 301
短链系统需要统计点击,而浏览器对 301 重定向会强缓存,后续访问不再触发服务器请求,点击数就丢了。所有跳转终点必须返回 302 Found 并设置 Location Header,同时禁用 Cache-Control: no-cache(不是 no-store)防止 CDN 缓存跳转响应体。
Revel 默认的 c.Redirect() 发的是 302,但要注意它会自动加 Content-Type: text/plain,这个 header 对跳转无用还可能干扰某些代理。应该手动构造响应:
ctx.Response.WriteHeader(302)
ctx.Response.Header().Set("Location", longURL)
ctx.Response.Header().Set("Cache-Control", "no-cache")
return nil
- 别在 redirect 前调用
c.Render()或任何模板方法,会触发 200 响应头覆盖 - 如果用了 Redis 缓存,命中时直接走上面手动响应;未命中才查 DB,查到后必须立刻回填缓存再响应
- 没查到短码时返回 404,不要 fallback 到首页或重定向到错误页,否则统计失真
部署时最常被忽略的 MySQL 和 Redis 配置项
本地开发用 Revel 自带的 dev server 没问题,但上线后 MySQL 连接池默认只有 10,Redis 默认不启用连接池,高并发下很快耗尽连接。这些值不在 conf/app.conf 的常规 section 里,得手动加:
MySQL:db.maxopen = 50、db.maxidle = 20、db.connmaxlifetime = "30m"
Redis:redis.poolsize = 30、redis.minidle = 5、redis.dialtimeout = "500ms"
-
db.connmaxlifetime必须设,否则连接长期空闲会被 MySQL server kill,Revel 不自动重连 - Redis 的
poolsize建议设为 CPU 核心数 × 5,不是越大越好,超量会拖慢 GC - 所有敏感配置(DB 密码、Redis 地址、混淆 seed)必须从环境变量读取,不要写死在 conf 文件里











