# 自动测试：证明规则，而不是只证明能编译

前置：[请求链路](../01-beginner/07-read-code.md) · 接着读：[手动验收](manual.md)

## 不依赖外部服务的检查

在项目根目录：

```powershell
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入口，不代表系统实现了完整图像解码验证。测试代码位置见[源码索引](../03-development/file-index.md)。

## 定位一条失败

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

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

## 覆盖率怎样看

```powershell
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和生产短信的真实上游不在默认测试覆盖里。

## 漏洞检查

```powershell
$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做真实页面操作。普通构建不要求安装浏览器；需要复现截图时：

```powershell
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，不能指向真实生产数据，因为它会注册、上传、发布和改资料：

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

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

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