# 07｜从一个点赞按钮读完整条后端链路

前一站：[Go 基础](06-go-basics.md) · 下一站：[SQL 与事务](08-sql-transactions.md)

## 先带一个问题

问题是：“为什么我反复发送点赞请求，它仍只增加一次？”不要从最大文件第一行读到最后一行，先追这一件事。读每一层时记下输入、规则、输出和失败会怎样。

| 顺序 | 文件 | 本轮只看什么 |
| --- | --- | --- |
| 1 | [App.tsx](../../frontend/src/App.tsx) | HomeScreen 的 toggleLike |
| 2 | [api.ts](../../frontend/src/api.ts) | likeNote、post 和 request |
| 3 | [server.go](../../internal/httpapi/server.go) | route、withIDs 和 like 路由 |
| 4 | [auth.go](../../internal/service/auth.go) | Authenticate 如何获得 Actor |
| 5 | [notes.go](../../internal/service/notes.go) | ReactNote 的 INSERT OR IGNORE |
| 6 | [schema.sql](../../internal/database/schema.sql) | note_likes 的组合主键 |
| 7 | [server_test.go](../../internal/httpapi/server_test.go) | 重复与并发点赞测试 |

## 第一层：页面只负责交互

toggleLike 先判断登录状态，再把当前按钮切到目标状态，调用后端。若请求失败，回到旧状态并显示错误，这叫乐观更新。它减少等待感，但最终事实仍由后端决定。只看页面数字不能证明数据库已正确写入。

## 第二层：API 封装统一网络细节

api.likeNote 根据目标状态选择 like 或 unlike，发送 `{id: noteId}`。request 从 localStorage 取 token，设置 Authorization，读取 JSON，遇到非成功状态抛出错误。页面并不自己拼每个请求头。

## 第三层：路由统一身份和输入

route 给请求加超时、限流和安全处理。带 token 时 Authenticate 验签并查 sessions；withIDs 读取 JSON 和整数范围。真正的操作者 Actor 来自认证结果，不来自 body.userId。然后调用 ReactNote。

未登录时 Actor 的 ID 为 0，读取公开内容可以继续，但写入方法中的 require 会拒绝。route 中 `public=true` 特指登录/发验证码入口不解析旧 token，不等于所有写入动作都免鉴权。

## 第四层：SQL 自己保证唯一

```sql
PRIMARY KEY(user_id, note_id)
```

这表示同用户同笔记只能出现一个组合。`INSERT OR IGNORE` 遇到已存在组合就不重复插入。可见性检查在 INSERT ... SELECT 内完成，避免先检查公开、稍后笔记变私密、再插入的分离窗口。

取消点赞直接 DELETE 对应组合，不存在时删除零行也算目标状态已达成。详情统计从关系表 COUNT，数字不会因为重试再次加一。这里的幂等依赖数据库约束，不依赖按钮禁用或前端时间戳。

## 第五层：用测试证明猜想

```powershell
go test ./internal/httpapi -run TestConcurrentLikeIsIdempotentAndDurable -v
```

测试同时发起 24 次相同点赞，验证最终为 1；再新建数据库连接模拟重启，确认还是 1。运行结果 PASS 表示这个断言通过，不等于程序任何情况下都不会出错。

## 第二轮自己追评论

用“回复不能属于另一篇笔记”作为新问题，从 publishComment 追到 PublishComment，再追 parent_id 和 reply_id。对照测试中的跨笔记回复返回 400。画出按钮、HTTP、身份、规则、SQL 五格，每格写一句话。

验收：你能在不背文件行号的情况下从按钮找到唯一约束，说明前端先变红与数据库真正成功的区别。
