本报告记录本机实际执行的检查。原项目 D:\xiaolanshu,新项目 D:\xiaolanshu-go;本地时区 Asia/Shanghai。源码重构与真实生产数据迁移是两回事,本次未连接或改写原Java数据库。
实现范围#
Go替代Java后端,按HTTP/业务/领域/存储/配置分层。覆盖普通与管理员登录、验证码注册、密码与会话撤销、资料头像、图文/视频笔记、详情/编辑/软删/私密与公开/置顶、赞藏、评论与回复、关注粉丝、分页搜索、后台管理、完整性检查、文件上传和静态站点。原内部RPC能力合并为同库方法,映射见迁移文档。
前端更新锁定依赖、规范统一响应、去掉默认演示回退、使用真实发布ID/作者/评论、真实关注信息流、密码与筛选映射、会话失效处理、本地图片和生活手册设计。加入本地工具准备、构建启动、验证脚本、容器配方和完整学习文档。
环境与证据#
Windows amd64;Go有效工具链1.26.11;项目本地Node24.22.3经官方SHA256核验;npm11.x;SQLite驱动1.62.0;React19.3.1、Vite7.3.8、TypeScript5.9.3。所有版本精确记录在锁文件。浏览器回归使用Playwright1.65.1和对应Chromium Headless Shell。
| 检查 | 结果与范围 |
|---|---|
| Go全包编译/集成测试 | 通过,临时SQLite;核心业务完整生命周期、权限、并发、分页、持久化 |
| Go配置测试 | 通过,开发密钥持久化、生产必填配置 |
| go vet | 通过 |
| go mod verify | 通过,all modules verified |
| 前端TypeScript与Vite构建 | 通过 |
| npm audit | 0个已知漏洞(本次查询时) |
| govulncheck v1.9.0 | No vulnerabilities found(本次漏洞库查询) |
| Windows真实启动 | 通过,健康、教学数据、验证码登录与profile |
| 浏览器静态检查 | 8张卡片、无坏图、无pageerror、桌面/手机无整页溢出 |
| 浏览器业务检查 | 注册验证码自动填入、真实上传/发布/作者/评论/点赞/编辑/资料/退出/管理员通过 |
| 浏览器宽度检查 | 320/390/768/1440,管理页面无整页横向溢出 |
| 文档链接与编码 | 34份Markdown、155个本地链接全部通过;10章初学顺序完整 |
跨包语句总覆盖率为69.3%(含启动入口与密码工具未执行分支),报告文件为根目录coverage.out。覆盖率不作为“全部正确”承诺。需要统计跨包覆盖时使用-coverpkg=./…,常规-cover不会对所有被跨包调用模块插桩;PowerShell对带点号参数加完整单引号,避免将coverage.out拆成coverage。
实际发现并修复的问题#
Windows file URI把D:当authority导致启动失败;根路径.被误认为文件扩展导致首页404;旧前端发布后构造假ID/作者;评论使用Date.now临时ID;首页固定搜生活、关注过滤写死用户;资料头像停留在blob预览;管理员分页解包差异;失效token残留;筛选枚举映射;中文PowerShell5.1脚本编码。以上均有针对性修复,并通过相应编译、集成或浏览器验证。
内置应用浏览器RPC在当前会话不可用,页面检查使用独立本地Playwright。浏览器下载曾遇到临时盘空间与网络问题,之后下载到项目.tools并完成实际运行;没有将下载失败算作验证成功。
截图#
未执行与明确限制#
没有真实Java业务快照导入、Docker镜像构建运行、公网HTTPS发布、真实短信供应商联调、视频codec转码、生产压测或Go race结果。本次不宣称多实例扩容、跨库消息对齐或ES分词能力。视频接口校验与存储已实现,真实不同浏览器视频兼容性需用目标媒体额外验证。
上传URL公开,笔记私密不构成私密媒体授权;当前头像/笔记弃用上传可能留下孤立文件;没有运营级审核与账户恢复。个人页置顶只在已加载游标数据中排序。SQLite单写连接属于教学/单实例取舍。对外部署前按生产文档补充并核验这些条件。
如何复现#
根目录运行scripts/verify.ps1;漏洞检查可加-Vulnerabilities。浏览器在独立18081服务和独立browser-check.db上执行scripts/visual-check.mjs与business-check.mjs,安装说明见自动测试章节。最终默认启动使用独立的data/xiaolanshu.db,不把演练注册/发布数据作为初始用户资料。