小蓝书 Go
零基础入门

03|浏览器、HTTP、JSON 和数据库

前一站:工具 · 下一站:第一次运行

一个按钮发生了什么#

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

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

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

看懂一份请求#

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

{"id":1}

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

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

响应有两层#

{"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 只是记住登录凭证,不等于保存了整套笔记数据。

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

— 本篇阅读完毕 —
来源:小蓝书 Go / docs / 01-beginner/03-web-basics.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭