小蓝书 Go
测试与验收

自动测试:证明规则,而不是只证明能编译

前置:请求链路 · 接着读:手动验收

不依赖外部服务的检查#

在项目根目录:

go test ./... -count=1
go vet ./...
go mod verify
npm.cmd ci --prefix frontend
npm.cmd run build --prefix frontend
npm.cmd audit --prefix frontend
python scripts/check-docs.py

-count=1 避免测试缓存隐藏这次运行;go vet 寻找常见静态问题;go mod verify 验证下载内容;构建包含 TypeScript 检查;audit 检查依赖公告;文档脚本检查链接、UTF-8和导航文件。任意失败先停止并阅读报错,不把多个失败归结为“电脑问题”。

统一入口 powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify.ps1。测试数据库在 t.TempDir,测试结束自动清理;不读取、清空默认实际数据库,不要求先启动 Go 服务、MySQL 或 Docker。

集成测试覆盖什么#

测试 行为性质
BusinessLifecycle 发布→互动→回复→私密→公开→删除;越权失败、跨笔记回复失败
AuthRevocationPasswordAndModeration 密码、退出、封禁、解除、软删与失效 session
CodeReplayAttemptsAndThrottling 验证码间隔、5次错误、单次消费、伪造token
FollowingSearchPaginationAndAliases 真实关注流、23篇分页、游标、字面通配符、旧网关路径
ConcurrentLikeIsIdempotentAndDurable 24并发同一赞只存1行,重开连接仍存在
UploadsRejectExecutableAndProfileUsesActor SVG拒绝、PNG MIME识别、伪造userId无法改他人资料
MalformedJSONUnknownAPIAndStaticFiles 非法JSON、未知API404、静态首页正常
DevelopmentSecretPersistsAndProductionRequiresExplicitConfig 开发密钥跨读取一致,缺失生产配置必须失败
NewerSchemaRejectedWithoutLeavingLockedConnection 较新schema明确拒绝,失败路径释放事务和连接

从HTTP请求走到真实临时SQLite,属于集成测试。文件测试中PNG样本只用于验证MIME入口,不代表系统实现了完整图像解码验证。测试代码位置见源码索引。

定位一条失败#

go test ./internal/httpapi -run TestBusinessLifecycle -v -count=1

看第一处不符合预期的 status/body,再回到对应 service。测试辅助方法失败会打印请求方法与路径,不打印用户密码和token。若期望403却500,多半是规则错误没有转成业务错误;若期望404却200,重点查对象可见性过滤。

覆盖率怎样看#

go test ./... '-coverpkg=./...' '-coverprofile=coverage.out' -count=1
go tool cover '-func=coverage.out'

外部集成测试跨包调用,所以要使用 coverpkg 才能同时统计service/database。PowerShell 5.1会拆分部分带等号和点号的参数,上面把完整标志放在单引号里,防止coverage.out意外变成coverage。普通 go test -cover 报某包0%不一定是从未执行,而可能是没有对被调用包插桩。覆盖率只说明哪些语句跑过,不能替代边界断言。main和生产短信的真实上游不在默认测试覆盖里。

漏洞检查#

$env:GOBIN='D:\xiaolanshu-go\.tools\bin'
go install golang.org/x/vuln/cmd/govulncheck@v1.9.0
.\.tools\bin\govulncheck.exe ./...

这只改变当前终端GOBIN,不写全局。govulncheck需要访问漏洞库;网络失败不是“No vulnerabilities found”。生产构建用受支持的Go补丁,前端保持lock。再次运行日后可能得到新公告,保存报告日期。

可选浏览器回归#

本次已使用Playwright 1.65.1做真实页面操作。普通构建不要求安装浏览器;需要复现截图时:

npm.cmd install --no-save --package-lock=false --prefix .tools/browser playwright@1.65.1
$env:PLAYWRIGHT_BROWSERS_PATH='D:\xiaolanshu-go\.tools\browsers'
$env:TEMP='D:\xiaolanshu-go\.tools\temp'
New-Item -ItemType Directory -Path $env:TEMP -Force
node .tools/browser/node_modules/playwright/cli.js install chromium --only-shell

另一个终端用独立数据库启动服务:$env:HTTP_ADDR='127.0.0.1:18081'; $env:DATABASE_PATH='data/browser-check.db'; go run ./cmd/server。先构建前端。浏览器脚本默认指向18081,不能指向真实生产数据,因为它会注册、上传、发布和改资料:

node scripts/visual-check.mjs
node scripts/business-check.mjs

visual-check截图并报告坏图、溢出和页面错误;business-check实际登录/上传/发布/评论/编辑/资料/退出/管理员与多个宽度。检查脚本使用固定开发管理员,若你的演练库已改密码需要修改演练配置。截图写入报告目录,运行结果必须以本次输出为准。

进阶可使用 go test -race,但Windows race模式需要CGO和相应C工具链;默认纯Go构建不要求它。本次报告不把未运行的race或生产压测当作已通过。

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