本页目录展开
  1. 账号:密码在 UniSSO,token 在主站
    1. 登录与错误码
    2. 鉴权:三套中间件与 PAT
    3. 改密、改邮箱、注销
  2. 帖子:读多写多,缓存怎么不炸
    1. 列表与详情
    2. 互动、搜索与热榜
  3. 评论与评分
  4. 三种 @,三种实现
    1. @ 用户:在渲染期做匹配
    2. @小秋:异步回帖
    3. @ 职位身份:真实身份与展示身份分离
  5. 投币:一个事务五步
  6. 在线人数:ZSET 滑动窗口
  7. 私信:WebSocket 与未读
  8. 工作台:内置兜底,动态应用验签
  9. 内容板块与社区功能
    1. 媒体:音乐、小说、视频
    2. 交易与工具:商城、简历、课程、需求、抽奖
  10. 个性化与管理端
    1. 勋章与皮肤
    2. 管理端:身份隔离与时间戳封禁
  11. 面试速答

软工集市主站是同学们发帖、评论、投币、私信、找资源的地方,前端在 newSSE,后端在 SSE_market_server。它要同时扛住高频读(列表、详情)和高频小写(浏览数、点赞、在线心跳),还要和 UniSSO、图床、iWiki 共享登录态。这篇按功能拆开讲实现,重点放在缓存一致性、并发约束和身份边界。

账号:密码在 UniSSO,token 在主站

账号操作统一收口到 UniSSO(sso.ssemarket.cn):注册、登录、改密、封号都在那里完成,主站只把拿到的身份换发成自己的 JWT,并种一个父域 Cookie,让主站、图床、iWiki 共享登录态。

注册只能从 sso.ssemarket.cn/register 走。主站的 POST /api/auth/register 只接受 UniSSO 的服务端调用,浏览器直接调返回 403——绕过 UniSSO 建的账号在统一身份里不存在,之后再登录会失败。链路是:前端用 SM2 加密密码,主站解密后校验两次输入一致、长度 ≥6,交给 service.Users.Register 校验验证码/CDKey 并查重(邮箱、手机号各自唯一),落库后返回 access + refresh。若 SSO 模式开启,再用刚设的密码换一次共享会话,失败不影响注册结果。

1
2
3
4
5
6
7
8
9
10
11
12
13
// controller/userController.go —— 只拦浏览器,不拦 UniSSO 的服务端调用
func Register(c *gin.Context) {
if browserAuthRequest(c) {
response.Response(c, http.StatusForbidden, 403, nil,
"注册请前往统一身份认证:https://sso.ssemarket.cn/register")
return
}
password1 := util.Decrypt(requestUser.Password) // 前端用 SM2 加密后的密码
password2 := util.Decrypt(requestUser.Password2)
if len(password2) < 6 { /* 422 密码不能少于6位 */ }
if password1 != password2 { /* 422 两次密码不相同 */ }
tokens, err := service.Users.Register(c.Request.Context(), domain.RegisterInput{ /* ... */ })
}

坑:browserAuthRequest 靠 Origin/Referer 判断,服务端调用天然没有这两个头,所以能精确区分「浏览器乱调」和「UniSSO 正常建号」,不用维护白名单。另外,邮箱唯一索引才是最终约束,「先查再插」在并发下会重复插入。

登录与错误码

登录时主站不校验密码,而是把邮箱密码交给 UniSSO 的密码校验接口,拿回身份后签发自己的 token。收益是改密、封号、二次验证都在 UniSSO 一处生效。不同失败原因对应不同状态码,前端据此给提示:

情况 状态码 提示
密码错 401 邮箱或密码错误
非学院内部成员 403 该账号没有软件工程学院内部权限
身份已绑其他集市账号 409 该统一身份已绑定其他集市账号
邮箱没有集市账号 422 请先注册
密码校验被禁 403 不允许通过密码校验登录
失败次数过多 429 已被临时锁定,请 15 分钟后再试
UniSSO 不可用 503 统一身份服务暂时不可用

代码里用 sentinel error 映射(ErrSsoBadCredentials / ErrSsoForbidden / ErrSsoConflict / ErrSsoNoLocalAccount / ErrSsoTooManyAttempts / ErrSsoUnavailable)。登录成功后 setSsoCookie 种父域 Cookie。

坑:Cookie 的名称、值、Domain、有效期全部从 UniSSO 响应里取,不能在主站写常量;硬编码域名会让本地开发和换域名都失效。登录失败要审计(SsoAudit 记录 mode/email/result),但绝不能记密码和完整 token。

鉴权:三套中间件与 PAT

路由分三组:StrictAuthMiddleware(必须登录)、OptionalAuthMiddleware(登录就给身份,游客也放行)、OAuthMiddleware(第三方带 scope)。严格鉴权先解析 Authorization: Bearer <token>,解析出用户后再进布隆过滤器挡刷接口。

OptionalAuthMiddleware 会校验 token,但失败也放行。所以凡是要读用户身份的地方必须显式判 nil——详情页「我点过赞没有」就靠它,游客看到未点赞状态,而不是报错。

浏览器之外的调用方(MCP、CI)走个人访问令牌 PAT:设置页创建,复制 sk_xq_ 开头的串,库里只存哈希;/api/auth/token/verify 供 MCP 网关用 PAT 换身份。MCP 入口用 ForumPATAuth 与 JWT 登录态物理隔离,并单独限流 30 次/分钟。PAT 的 scope 只能收窄不能放大,吊销与删除分开(吊销保留记录,删除抹掉)。

坑:长期令牌不能和登录态共用签名密钥,否则轮换 JWT 密钥会把所有 PAT 一起废掉;它也必须有自己的吊销通道。

改密、改邮箱、注销

三个动作都要求先验身份:改密验旧密码,改邮箱验新邮箱验证码,注销做软删 + 清会话 + 解绑 UniSSO,不物理删数据。改邮箱撞唯一索引直接 422。

坑:改密后必须清掉旧的 refresh(refresh_tokens),否则账号被盗后攻击者能一直用旧 refresh 续期,改密等于没改。

帖子:读多写多,缓存怎么不炸

发帖链路有四步:前端先传图拿 COS 地址,拼进 Markdown;提交 POST /api/auth/post,后端校验标题长度、正文非空、分区合法;匿名帖在读的时候才脱敏,库里仍存真实 user_id(否则作者自己都找不回帖子);写库成功后让列表缓存换代,并触发 @ 解析。

列表缓存用 generation 版本号:发帖不删缓存,只把版本号 +1,旧 key 自然失效。

1
2
3
4
5
6
// service/browse_feed.go(示意)—— 公共 Feed 带 generation,写入即换代
func (s *BrowseService) InvalidateHomeBrowse() {
core.MyRedis.Incr(ctx, "post:browse:generation")
}
// 读时把 generation 拼进缓存键,换代后自然 miss,不用 SCAN 删旧键
cacheKey := fmt.Sprintf("post:browse:home:%s", gen)

坑:SCAN 遍历大量键会阻塞单线程 Redis,失效操作要 O(1)。匿名不是加密,一旦有人写新接口忘了脱敏就泄露,所以脱敏要收口到统一的 anonymizeAuthor 出口。

列表与详情

列表所有筛选维度收进一个 BrowseFilter,避免每种组合写一个接口;缓存按 feed 类型分开,home、history(浏览足迹)、save(收藏)、rating(评分专区)各自独立键。

详情整包缓存 post:detail:<id>。浏览数不进 MySQL 同步写,而是 Redis INCR + 脏标记,5 秒批量回写:

1
2
3
4
5
6
7
8
9
10
11
12
13
// service/hot_data_service.go
func (s *HotDataService) IncrBrowseCount(postID int) int64 {
if !s.redisHealthy {
return s.browseNumFromDB(postID) // Redis 挂了直接降级查库
}
s.ensureBrowseCountKeySeeded(postID) // 首次从 DB 播种,避免从 0 开始
n, err := core.MyRedis.Incr(ctx, util.GetPostBrowseCountKey(postID)).Result()
if err != nil {
return s.browseNumFromDB(postID)
}
s.browseDirty.Store(postID, time.Now()) // 打脏标记,后台每 5s 批量落库
return n
}

坑:播种不能省。key 不存在时直接 INCR,浏览数会从 1 开始,等于把历史数据清零。浏览数这种高写低读的计数直接 UPDATE ... SET num = num + 1 会把行锁打爆。

分页用的是 OFFSET,深页会全表扫。数据量上来必须换游标(WHERE id < last_id);total 的聚合也贵,可以单独维护计数表,或前端只做「加载更多」不展示总页数。

互动、搜索与热榜

点赞是关系表和计数两处写,同一事务;收藏进「我的收藏」独立表;关注帖子单独一张表,区别于关注作者;私密只改 visible 不删数据;删除是软删并从所有 feed 移除。统一规则:**任何改变详情内容的写操作都要失效 post:detail:<id>**,因为点赞数、评论数、投币数都在这个缓存里。

坑:点赞/取消会来回打,±1 并发会漂,要么用唯一索引加计数表定期重算,要么接受误差并校准。软删的代价是所有查询都得带 deleted_at IS NULL,漏一处就「删了还能搜到」,靠 GORM 软删钩子统一处理。

搜索走标题 + 正文匹配,可见性过滤必须在服务端做,不能把私密帖下发到浏览器再过滤。热榜分数离线算好,公式(CalculateHeat)是赞 +3、浏览 +1、评论 +6,删评论按 0.5^days 衰减;纯计数会让老帖永远占榜。

评论与评分

一级评论的校验顺序本身就是设计:内容非空 → 长度 ≤1000 字(按 rune)→ 用户身份 → 是否禁言 → 帖子是否存在。

1
2
3
4
5
6
// controller/commentController.go
if len(msg.Content) == 0 { /* 400 评论内容不能为空 */ }
if utf8.RuneCountInString(msg.Content) > 1000 { /* 400 评论内容过长 */ }
user, ok := requireViewerLegacyPhone(c, msg.UserTelephone)
if !ok { /* 422 权限不足 */ }
if user.BanEnd.After(time.Now()) { /* 400 你尚处于禁言状态中,不得评论 */ }

坑:len() 算字节,一个中文 3 字节,用它会 333 字就报超长,必须 utf8.RuneCountInString。禁言返回 400,429 是「请求太快」,语义不能混。

楼中楼单独一张 ccomment 表,parent_id 指向一级评论;列表只查当前页的一级评论,再批量捞二级,避免 N+1。只做两层,不做无限嵌套,第三层统一挂到二级下面并 @ 被回复人。评论点赞与点踩互斥;删一级评论要级联失效二级,并清 comment:list:<postID>:<type>。

评分专区是完全独立的一套表,链路为分类 → 评分贴 → 星级提交(每人每帖一次)→ 评分评论。因为「一人一票」「星级聚合」需要独立唯一索引,复用通用评论表只能到处加 WHERE type = 'rating'。

三种 @,三种实现

@ 用户:在渲染期做匹配

Markdown 正文是纯文本,@张三 后面可能紧跟标点、中文或 HTML 标签,结束位置不好定。做法是编辑期只记候选,渲染期拿已知用户表按昵称长度降序做最长前缀匹配,命中后再判断边界(空白/标点/CJK/HTML 标签)。提交时还要生成「剥尾部标点」的变体,兼容 @张三,你好 这种输入。

1
2
3
4
5
6
7
8
9
10
11
12
13
// newSSE/src/utils/mention.ts —— 生成候选变体:原名 + 逐字符剥标点
export function mentionCandidates(captured: string): string[] {
const cur = captured.trim()
if (!cur) return []
const set = new Set<string>([cur])
for (let i = 0; i < cur.length; i++) {
if (PUNCT_RE.test(cur[i])) {
set.add(cur.slice(0, i)) // "@张三,你好" → "@张三"
set.add(cur.slice(0, i + 1)) // 也保留带标点的版本
}
}
return [...set].filter(Boolean).sort((a, b) => b.length - a.length) // 长的优先
}

解析接口 ResolveMentions 必须批量:前端用全局 Map 缓存已知昵称,只把缺失的名字一次提交。渲染期匹配还有个好处——用户改名后旧帖仍指向正确的人;发布时写死链接就会失效。

@小秋:异步回帖

正文出现 @小秋 后,后端异步处理,主请求立即返回,十几秒后 bot 以评论形式回复。三个细节必须处理:goroutine 里不能用请求的 ctx(请求返回就取消);bot 要用自己的身份回帖,不能用提问者身份;去重要两层,sync.Map 挡同一次触发,actor 侧再挡 60 秒窗口。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// controller/xiaoqiu_at.go(示意)
go func() {
// 关键:脱离请求生命周期
ctx, cancel := context.WithTimeout(context.Background(), 120*time.Second)
defer cancel()
if _, loaded := trigger.LoadOrStore(key, struct{}{}); loaded {
return // 同一触发不重复处理
}
reply, err := agentClient.Chat(ctx, prompt) // 内网 Agent
if err != nil { return }
_ = service.Comments.CreatePcomment(ctx, domain.PcommentCreateInput{
UserID: xiaoqiuBotUserID, PostID: postID, Content: reply,
})
}()

坑:私密帖必须静默跳过,否则 AI 可能把私密内容带进公开回复。异步任务要有界:超时、去重、失败不重试爆量。

@ 职位身份:真实身份与展示身份分离

开发人员可以「以职位身份回复」,显示岗位名而不显示个人昵称。每个职位对应一个 staff alias 账号,评论表存两个 user_id:UserID 是真实作者,AsStaffUserID 是展示身份。

坑:权限判断必须用真实作者,展示才用 alias。写反了就会出现「匿名职位账号能改别人帖子」的越权。

投币:一个事务五步

约束:每人每个内容最多 2 币,不能给自己投,私密/已删内容不能投。一次投币在一个事务里做五件事:扣用户币、写投币记录、投币者加经验、作者分成、记流水;成功后失效 post:detail 和首页 Feed(两者都带 coin_num)。

1
2
3
4
5
6
7
8
// service/coin_service.go —— 目标校验 + 分成 + 缓存失效
post, err := s.posts.FindPublicByID(ctx, targetID) // 私密帖查不到 → 不可投
if post.UserID == userID { return nil, domain.ErrCoinSelf }
result, err := s.coins.Throw(ctx, domain.CoinThrowInput{ /* UserID, AuthorID, TargetType, TargetID, Coins */ })
if targetType == domain.CoinTargetPost {
InvalidatePostDetail(targetID) // 详情里有 coin_num
InvalidateHomeBrowse() // Feed 里也有
}

常量:CoinMaxPerTarget = 2,投币者 +10 经验/币,作者 0.1 分成/币。涉及的表是 coin_throw 与币流水。

坑:数量上限不能只靠代码判断。「先查已投 1 枚、再投 1 枚」的两个并发请求都会通过,唯一索引 (user_id, target_type, target_id) 才是最终约束。

取消投币一次全部撤回:删投币记录、退币、回退双方经验和分成、记一条反向流水、失效缓存,不做「只退 1 枚」。取消以 coin_throw 记录为凭证,不要求目标内容还存在,内容删了也能退。反向流水要单独记 refund 类型,不能直接删原流水,否则对账时收入和支出对不上。

余额汇总走 GET /api/auth/coin/summary 实时查,不读会话快照——快照会偏旧,投完再开弹窗会显示旧余额。流水按时间倒序分页,排行榜按投币数聚合用 ZSet。历史投票功能已下线,票数折算成已投的币保留展示,不清零。

在线人数:ZSET 滑动窗口

前端登录后每 60 秒发一次心跳,切到后台暂停,切回前台立即补报。心跳模块是模块级单例,整个应用只有一份;徽标组件自己不起定时器,只切换场景。否则路由跳转不销毁实例,定时器越积越多,人数被重复计入。

后端用两个 ZSET:全站 presence:online、场景 presence:scene:<scene>:<id>;member 是用户 ID,score 是毫秒级心跳时间戳。统计窗口 150 秒,超时即离线。查询时一个 Pipeline 先清过期再计数,只发一次 RTT。

1
2
3
4
5
6
7
8
// service/presence_service.go
opCtx, cancel := context.WithTimeout(context.WithoutCancel(ctx), time.Second)
prevSceneKey, _ := core.MyRedis.Get(opCtx, currentKey).Result()
pipe := core.MyRedis.TxPipeline()
if prevSceneKey != "" && prevSceneKey != newSceneKey {
pipe.ZRem(opCtx, prevSceneKey, member) // 切场景要摘掉旧集合,否则人数虚高
}
// 同一管道里再 ZREMRANGEBYSCORE 清过期 + ZCARD 计数

常量:PresenceWindow = 150s、PresenceHeartbeatHint = 60、PresenceKeyTTL = 5min。

坑一:切场景只 ZAdd 新集合、不 ZRem 旧集合,用户会在两个场景同时「在线」。坑二:用请求 ctx 写 Redis,客户端一断开就取消,心跳白写;要 context.WithoutCancel 剥掉取消信号但保留超时。Set 只能整键过期,没法按时间清人,所以这里必须用 ZSET。

私信:WebSocket 与未读

私信走 WebSocket,clientMap 存「用户 ID → 连接」,建连后一个协程只发、一个只收。消息先落库再投递:对方在线且开着这个会话就直推,否则未读 +1。

1
2
3
4
5
6
7
8
9
10
11
12
13
// controller/chat.go —— token 允许走 query,因为原生 WebSocket 客户端带不了自定义 Header
func ChatHandler(c *gin.Context) {
userInterface, ok := c.Get("user")
if !ok {
tokenString := c.Query("token")
_, claim, err := common.ParseToken(tokenString)
if err != nil { /* 请重新登录 */ }
userID = claim.UserID
} else {
userID = userInterface.(*domain.User).ID
}
chatFunc(c.Request, c.Writer, userID)
}

发送 channel 必须带缓冲(make(chan []byte, 200))。无缓冲 + 对端不收 = 发送方阻塞,一个慢客户端就能拖死整个推送循环。

未读用两件套:计数键 {sender}RecvUnread{target}_{lane} 做 O(1) 增减,索引集合 chatUnreadIndex:<uid> 记录哪些会话有未读,进会话时清零并从索引删掉再广播已读。SCAN chatUnread:* 是 O(N) 且阻塞 Redis,不能这么查。

撤回限 2 分钟,把消息状态置为已撤回(不删行),落库后通过 WebSocket 广播给双方。只改本地状态,接收方仍能看到原文。

坑:CheckOrigin 直接 return true 有风险,生产要校验来源域名。推送只是加速,消息以落库为准,刷新后从库里拉历史。

工作台:内置兜底,动态应用验签

工作台有 9 个固定卡片:排行榜、小秋、打分、小说、简历、商城、iWiki、课程专区、学人汇。这些内置入口写死在前端,不走接口,后端挂了也能点,是可用性兜底。开发者平台注册的动态应用存 workbench_apps 表,type 只有 route(站内 router.push)和 link(window.open)两种,按名称去重后追加在内置卡片后面。

坑:link 类型必须做 URL 白名单,否则任何人都能往工作台塞钓鱼链接。开发者平台要远程给用户建应用,走一对内部接口(建、查),调用方带 SM2 签名,主站用 platformInvoker 验签通过才落库。这样开发者平台不用碰主站数据库;共享库会把两个平台的发布节奏和表结构绑死。

内容板块与社区功能

媒体:音乐、小说、视频

音乐上传走 COS,播放走 noauth 媒体路由——<audio> 标签带不了 Authorization 头,只能放开鉴权,用不可猜的路径保护。帖子内嵌音乐分三步:先把独占一行的 ::music 12:: 替换成占位 div,渲染后收集所有 id 一次拉回标题/封面/时长,播放交给 Howler.js(支持 Range,可边下边播、拖进度条)。直接生成 audio 标签会让长帖里的 5 首歌一进页面就并发加载,占位 + 点击才加载才省流量。

小说是三级结构「书 → 章 → 段」,评论也分三级,书架和阅读进度各一张表。签到有连胜和当日去重,靠唯一索引挡重复,昨天签过 streak + 1,否则重置为 1,再按 streak 发积分写流水。段评按「章节 + 段落序号」定位,段落是 Markdown 渲染后的第 N 个块,编辑改字就可能错位,所以段评只在发布态可见。

视频走对象存储 + 转码,播放用 HLS/mp4 直链,播放记录单独表支持「继续观看」。大文件必须前端直传 COS,不能过 Go 服务——一次 500MB 上传就能打满内存。

交易与工具:商城、简历、课程、需求、抽奖

商城是常规 CRUD + COS 图片,首页轮播只取「在售 + 有图」的商品。

简历每人最多 5 份,文件存 COS。预览只下发 30 分钟有效的临时 URL(resumeDownloadURLTTL = 30 * time.Minute),永久直链不下发;下载接口挂 OptionalAuth,允许「登录 Bearer」和「签名链接」二者校验其一。签名要包含过期时间和文件 ID,用服务端密钥 HMAC,否则参数可伪造。简历是隐私数据,直链泄露就是永久泄露。

课程专区是目录树 + 对象存储前缀,上传走后端发凭证、前端直传。需求(quest)用状态机驱动:待接单 / 进行中 / 已完成 / 已关闭,每次流转校验当前状态,防止「已完成」再被接单。抽奖创建时校验奖品和名额,参与用唯一索引挡重复,开奖按参与记录随机取并落表;开奖必须幂等,用 WHERE status = 'open' 条件更新,连点两次不能抽出两批人。意见反馈是单表 + 状态字段。

个性化与管理端

勋章与皮肤

勋章有三类来源:注册周年(定时任务自动发)、节日限定、特殊成就。定时发放必须幂等,任务可能因部署、补数据、手动触发而重跑,靠唯一索引 (user_id, badge_id) 兜底。展示有上限:主页勋章墙最多 30 枚,批量查询限 100 人——一次查 1000 人的勋章墙会产生 1000 次关联查询。

皮肤靠前端 CSS 变量切换,不重新加载页面。全站主题是「活动 + 时间窗 + 双图」,游客也能读到当前主题,否则未登录用户会先看到默认皮肤再闪变。自定义皮肤要限制图片尺寸和格式,否则一张 20MB 的图会让所有人首屏卡住。小秋在独立页是同步问答,和帖子里 @小秋 共用同一套内网 Agent,只是入口不同。

管理端:身份隔离与时间戳封禁

管理端只能用 UniSSO 登录,且必须是学院成员 + 在白名单里。管理员 token 单独签发、有效期 1 天,短于用户 token 的 7 天,并且两者隔离,用户 token 调管理接口返回 401。

封禁存 ban_end 时间戳而不是布尔值,判定统一写 user.BanEnd.After(time.Now()),到期自动恢复,不需要定时任务解封。用 is_banned 就必须有定时任务,任务一挂就永远封着。

内容治理里,举报成立后自动走 MarkViolation:结案、按 MarkFinishedByTarget 把同一目标的多条举报一次结案、算惩罚、禁言作者、通知作者、通知举报人,一次事务完成。通知必须同时发给被罚者和举报人,只通知被罚者,举报人不知道结果,下次就不举报了。

推荐流的模式是配置项,可实时切换不用发版;effectiveMode 在配置缺失时返回默认模式,避免配置中心挂了服务跟着 500。CDKey 是注册激活码,一次性使用;OAuth 应用管理控制哪些第三方能拿用户身份。

面试速答

  • 鉴权:用户 JWT 7 天、管理员 JWT 1 天、OAuth2 access 5 分钟,三套物理隔离;PAT(sk_xq_)给 MCP,入口单独限流 30 次/分。
  • 登录:密码由 UniSSO 校验,主站只换发 token 并种父域 Cookie;错误码细分 401/403/409/422/429/503,429 是锁定 15 分钟。
  • 缓存:列表用 generation 版本号整体换代(O(1)),详情主动失效 post:detail:<id>,浏览数脏标记 5 秒批量回写且首次要播种。
  • 在线:两个 ZSET(全站 + 场景),150 秒滑动窗口,单次 Pipeline 清过期 + 计数;切场景必须 ZREM 旧键,写 Redis 用 context.WithoutCancel。
  • 投币:唯一索引 (user_id,target_type,target_id) 兜住每人每内容 ≤2,单事务五步,取消以投币记录为凭证、退币记独立的 refund 流水。
  • **三种 @**:@用户是渲染期最长前缀匹配;@小秋是 goroutine + context.Background() + 双层去重;@职位身份是真实身份与展示身份分离,权限只看真实作者。

→ 下一篇:集市云:一组一容器