不依赖外部服务的检查#
在项目根目录:
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或生产压测当作已通过。