铁律存档:测试端口固定=5173(2026-11-15 用户裁定)——activeContext 铁律条+techContext 端口段(顺带修正网关历史 8081→现行 8080 口径)+Makefile web-dev 注释同步;废止过时坑条目(.env.development.local 钉 real,Mock 已下线)

This commit is contained in:
2026-11-15 07:50:30 +08:00
parent c5a062570f
commit 2088c1c65f
3 changed files with 4 additions and 3 deletions
+1 -1
View File
@@ -113,7 +113,7 @@ docker-build: ## 构建服务镜像(默认 gateway,可 SERVICE=business 等)
# ---- Web 端线上测试(Day 36 增补;Mock 模式零依赖,无需后端/中间件) ----
WEB_PORT ?= 5173
web-dev: ## 启动 Web 开发服务(单一 real 模式,S3·FE-6 Mock 已下线;WEB_PORT=5173 可覆盖)
web-dev: ## 启动 Web 开发服务(单一 real 模式;【铁律】测试端口固定=5173,WEB_PORT 勿覆盖)
@mkdir -p logs
@if ss -tln 2>/dev/null | grep -q ":$(WEB_PORT) "; then \
echo ">> 端口 $(WEB_PORT) 已被占用(可能已在运行): make web-log 查看 / make web-stop 停止"; exit 1; fi
+2 -1
View File
@@ -9,6 +9,7 @@
- **24h 稳定性门槛 ✅ 终判通过**(S5 压测前置确认)。
- **六项裁决速查(S2 全闭环)**:R1/R6 换算只在 price.go / R2 事实源 D2 落账 / R3 双通道 D3 落地(ref_id 区分)/ R4 rebate_rate D5 落地(profit.go 现算不落档)/ R5 settle_ladder D4 落地。
- 归档仓(只读):/data/poc-archive/repos/go-sms.git。
- **【铁律】测试端口固定=5173**:Web 测试/联调/走查/对外验收口径**一律** `http://<服务器IP>:5173`(vite dev,`make web-dev`);**禁止**用 WEB_PORT 覆盖到其他端口、禁止 preview(4173 等)/临时容器端口(30099 等)作为验收与走查入口——一次性探测端口仅限本机调试且不入文档口径(2026-11-15 用户裁定)。
- **本会话教训**:①明细雪花 ID 直插 SQL 须 < int64 上限 9.22e18(9302… 段拒收,走查种子统一 7302… 段);②`sg docker -c '…$VAR…'` 单引号内变量不展开(内层空展开致 SQL 语法错)——多语句 SQL 用 `printf|docker exec -i` 外层展开;③网关重启须含最新端点二进制(串行 build→kill→md5);④**本机 chromium(含 headless shell)newPage 即 Target crashed**(disable-gpu/no-sandbox/GLIBC 关 AVX 均不救,dmesg 无痕)——Playwright 截图/e2e/LCP 实测本机不可用,S5 真浏览器指标前先解此环境项;⑤vite preview 只监听 IPv6 [::1](curl 127.0.0.1 不通,用 localhost);⑥组件测试 mount 须 `plugins:[ElementPlus]`(stubs 方式 el-table-column slot scope 会 undefined);⑦`web/.env.development.local` 已随 Mock 下线删除,再出现 VITE_API_MODE 文件即残留可径删。
- **历史运维教训**:①`pkill/pgrep -f` 自匹配(铁律:`[x]` 括号技巧);②大镜像单窗>体积÷带宽;③du 无 sudo 静默失败误诊;④sed 换行/sed 误伤方法名(重构期优先编辑器工具);⑤Go 工具忽略 `_` 前缀文件;⑥集成测试需 `sg docker` 包裹(docker 组未重登);⑦**Makefile recipe 的 `exit 0` 只退出当前行 shell 不终止目标**(幂等短路须 if/else 递归 `$(MAKE)` 子目标);⑧**管道 `| tail -N` 截首行误导诊断**(gw-start"玄学 NOMATCH"两轮误诊实为 THEN 分支已生效,排查须看全量输出)。
@@ -47,7 +48,7 @@
## 常踩的坑(防复发)
1. `.env.development.local`(gitignore)会把 vite 钉在 real 模式——切 mock 前必查。
1. ~~`.env.development.local` 会把 vite 钉在 real——切 mock 前必查~~(S3 Mock 已下线,条目废止留痕;该文件已删,再出现 VITE_API_MODE 相关文件即残留径删)。
2. build 与 kill 并行=旧 inode 进程(Day 70);部署必须串行+md5 比对。
3. 持久化-还原键字段必须成对审计(Day 71 ref 字段漏存教训)。
4. 迁移版本号字典序坑(v10<v9,Day 46 修);gofmt 的 `//` 注释误闭合致 vite 编译错(W4)。
+1 -1
View File
@@ -38,7 +38,7 @@
| MinIO | 19010/19011(API/Console) | |
| Prometheus+Alertmanager | — | 规则 `deploy/monitoring/alert_rules.yml` |
网关 dev 固定 **:8081**(`GW_PORT`,8080 被宿主旧进程占用);Web :5173;K8s NodePort 30080/30081。
网关 dev 固定 **:8080**(`GW_PORT` 可覆盖;历史 8081 为当时宿主 8080 被占用的临时覆盖,已废弃,vite proxy 按 8080);**Web 测试端口铁律=5173**(`make web-dev`,vite dev;测试/联调/走查/验收一律此端口,WEB_PORT 不得覆盖、preview/临时容器端口不入口径,2026-11-15 用户裁定);K8s NodePort 30080/30081(S5 灰度 apply)。
## 常用命令