# 03｜浏览器、HTTP、JSON 和数据库

前一站：[工具](02-tools.md) · 下一站：[第一次运行](04-first-run.md)

## 一个按钮发生了什么

点击“点赞”时，React 读取你当前看到的笔记 ID，调用 `api.likeNote`。接口封装用 fetch 发送 HTTP 请求。Go 根据请求路径找到处理函数，验证 token，向数据库插入一条点赞关系，最后返回 JSON。页面收到成功结果后维持已点赞状态，失败则恢复原状并提示。

```text
你的点击 → React → HTTP 请求 → Go 规则 → SQLite
              ↑                  ↓
              └──── JSON 响应 ────┘
```

浏览器没有直接操作数据库；否则任何访客都可能跳过权限检查。数据库也不负责画按钮，它专门保存与查询有结构的数据。

## 看懂一份请求

```http
POST /api/note/note/like
Content-Type: application/json
Authorization: Bearer <登录后得到的token>

{"id":1}
```

`POST` 是请求方法；路径选择动作；请求头说明内容格式和身份；最后一行是请求体。这里 `id` 是笔记 ID，不是用户 ID。操作者来自已验证的 token，因此不能靠传一个别人的 userId 来冒充对方。

JSON 的对象用 `{}`，数组用 `[]`，文字用双引号，数字不加引号，布尔值为 `true` 或 `false`。字段区分大小写，末尾不能多逗号。

## 响应有两层

```json
{"success":true,"data":{"noteId":1,"isLiked":true}}
```

HTTP 状态码说明请求总体是否被处理：200 成功，400 参数错误，401 需要重新登录，403 权限不足，404 内容不存在或不可见，409 冲突，429 太频繁，500 服务内部出错。JSON 的 `data` 才是业务内容。`api.ts` 统一取出 data，所以页面代码不用每次写两层 `.data`。

分页响应在业务 data 内还有一个 `data` 数组，这两个 data 不是同一个层级。先画出结构再读：外层是统一响应，内层是“这一页的记录”。

## 开发模式为什么有两个地址

`8080` 是 Go；`5173` 是 Vite，用于改前端时自动刷新。Vite 把 `/api` 请求转给 Go，浏览器仍以为在访问当前网站，这叫开发代理。正式构建后 Go 同时提供页面和 API，浏览器只访问 8080。`localhost` 与 `127.0.0.1` 常指本机，但浏览器认为它们是不同来源，教程统一使用后者。

## 数据库为什么不能用页面数组代替

页面数组存在内存里，刷新或关闭就可能消失。数据库文件持久保存；再次请求会重新读到同一条记录。浏览器缓存 token 只是记住登录凭证，不等于保存了整套笔记数据。

验收：你能指出一次请求的方法、路径、请求头、请求体和响应；能解释刷新页面和重启后端的区别。下一章将亲眼观察这条链路。
