From d8a77f120cbf47742771aae48f1651a7a1e02400 Mon Sep 17 00:00:00 2001 From: Tory Date: Sun, 15 Nov 2026 11:37:53 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A4=96=E7=BD=91=E6=B5=8B=E8=AF=95=E9=80=9A?= =?UTF-8?q?=E9=81=93=E6=94=B9=E7=8B=AC=E7=AB=8B=E5=9F=9F=E5=90=8D=20sms.un?= =?UTF-8?q?imsc.com(2026-11-15=20=E7=94=A8=E6=88=B7=E8=A3=81=E5=AE=9A):=20?= =?UTF-8?q?vite=20server.allowedHosts=20=E7=99=BB=E8=AE=B0=E5=9F=9F?= =?UTF-8?q?=E5=90=8D(=E4=BF=AE=20nginx=20=E5=8F=8D=E4=BB=A3=20403=20Blocke?= =?UTF-8?q?d)+hmr.clientPort=3D443(=E5=9F=9F=E5=90=8D=E9=80=9A=E9=81=93=20?= =?UTF-8?q?HMR=20=E7=BB=8F=20nginx=20Upgrade=20=E5=A4=B4=E5=9B=9E=E6=B5=81?= =?UTF-8?q?;=E6=9C=AC=E6=9C=BA=E7=9B=B4=E8=BF=9E=20HMR=20=E9=80=80?= =?UTF-8?q?=E5=8C=96=E4=B8=BA=E6=89=8B=E5=8A=A8=E5=88=B7=E6=96=B0,?= =?UTF-8?q?=E9=9D=99=E6=80=81=E5=8F=96=E8=88=8D=E5=9F=9F=E5=90=8D=E4=BC=98?= =?UTF-8?q?=E5=85=88)+=E6=96=B0=E5=A2=9E=20web/.env.production(VITE=5FAPI?= =?UTF-8?q?=5FBASE=5FURL=3D/api/v1)=E2=80=94=E2=80=94=E4=BF=AE=20S3=20?= =?UTF-8?q?=E9=9A=90=E8=97=8F=E7=BC=BA=E9=99=B7:build=20=E4=B8=8D=E8=AF=BB?= =?UTF-8?q?=20.env.development=20=E8=87=B4=20dist=20=E4=BA=A7=E7=89=A9=20A?= =?UTF-8?q?PI=20base=20=E7=BC=BA=E5=A4=B1;ai.unimsc.com/SmsDev=20=E5=89=8D?= =?UTF-8?q?=E7=BC=80=E9=80=9A=E9=81=93=E5=BA=9F=E5=BC=83(=E5=89=8D?= =?UTF-8?q?=E7=BC=80=E5=8F=8D=E4=BB=A3=E4=B8=8B=E8=B5=84=E6=BA=90=E7=BB=9D?= =?UTF-8?q?=E5=AF=B9=E8=B7=AF=E5=BE=84=E9=94=99=E4=BD=8D=E6=97=A0=E5=B9=B2?= =?UTF-8?q?=E5=87=80=E8=A7=A3);=E9=93=81=E5=BE=8B=E5=AD=98=E6=A1=A3=20acti?= =?UTF-8?q?veContext+techContext;=E9=AA=8C=E8=AF=81=3DHost=20=E5=A4=B4?= =?UTF-8?q?=E6=A8=A1=E6=8B=9F=E5=9F=9F=E5=90=8D=20200(=E6=9C=AA=E7=99=BB?= =?UTF-8?q?=E8=AE=B0=E5=9F=9F=E5=90=8D=E4=BB=8D=20403=20=E9=98=B2=E6=8A=A4?= =?UTF-8?q?=E4=BF=9D=E6=8C=81)/=E6=9C=AC=E6=9C=BA=20200/API=20proxy=20401/?= =?UTF-8?q?=E5=9B=9B=E4=BB=B6=E5=A5=97=20148=20=E5=85=A8=E7=BB=BF+build=20?= =?UTF-8?q?=E4=BA=A7=E7=89=A9=E5=90=AB=20api/v1=20=E9=9B=B6=E5=9F=9F?= =?UTF-8?q?=E5=90=8D=E6=AE=8B=E7=95=99;=E7=94=A8=E6=88=B7=E4=BE=A7?= =?UTF-8?q?=E5=BE=85=E5=8A=9E:DNS=20A=20=E8=AE=B0=E5=BD=95+certbot=20?= =?UTF-8?q?=E7=AD=BE=E8=AF=81=E4=B9=A6+nginx=20=E8=B4=B4=20server=20?= =?UTF-8?q?=E5=9D=97=20reload?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- memory-bank/activeContext.md | 1 + memory-bank/techContext.md | 2 +- web/.env.production | 4 ++++ web/vite.config.ts | 7 +++++++ 4 files changed, 13 insertions(+), 1 deletion(-) create mode 100644 web/.env.production diff --git a/memory-bank/activeContext.md b/memory-bank/activeContext.md index 39b0a564..68f1e393 100644 --- a/memory-bank/activeContext.md +++ b/memory-bank/activeContext.md @@ -10,6 +10,7 @@ - **六项裁决速查(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 用户裁定)。 +- **【铁律】外网测试统一域名入口=`https://sms.unimsc.com/`**(2026-11-15 用户裁定):nginx 根路径反代 443→192.168.5.18:5173(带 ws Upgrade 头);vite `allowedHosts:['sms.unimsc.com']`+`hmr.clientPort:443`(域名 HMR ✓,本机直连 HMR 退化为手动刷新);API 走 vite proxy→8080;**ai.unimsc.com/SmsDev 路径前缀通道废弃**(前缀反代下 vite 资源绝对路径错位无干净解);S5 上生产仅改 nginx proxy_pass→30081(web 镜像同构)。**S3 遗留缺陷顺手修**:build 不读 .env.development 致 dist 内 API base 缺失→新增 `web/.env.production`(VITE_API_BASE_URL=/api/v1)。 - **本会话教训**:①明细雪花 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 分支已生效,排查须看全量输出)。 diff --git a/memory-bank/techContext.md b/memory-bank/techContext.md index 6280cbae..1635fd37 100644 --- a/memory-bank/techContext.md +++ b/memory-bank/techContext.md @@ -38,7 +38,7 @@ | MinIO | 19010/19011(API/Console) | | | Prometheus+Alertmanager | — | 规则 `deploy/monitoring/alert_rules.yml` | -网关 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)。 +网关 dev 固定 **:8080**(`GW_PORT` 可覆盖;历史 8081 为当时宿主 8080 被占用的临时覆盖,已废弃,vite proxy 按 8080);**Web 测试端口铁律=5173**(`make web-dev`,vite dev;WEB_PORT 不得覆盖、preview/临时容器端口不入口径);**外网测试统一入口=`https://sms.unimsc.com/`**(nginx 根路径反代 443→5173+ws Upgrade,vite allowedHosts 已登记;ai.unimsc.com/SmsDev 前缀通道废弃);K8s NodePort 30080/30081(S5 灰度 apply)。 ## 常用命令 diff --git a/web/.env.production b/web/.env.production new file mode 100644 index 00000000..d346c38c --- /dev/null +++ b/web/.env.production @@ -0,0 +1,4 @@ +# build(mode=production)不读 .env.development——此前 dist 产物内 VITE_API_BASE_URL +# 为 undefined,axios 请求缺 /api/v1 前缀,S3 web 镜像内前端 API 实为断链(冒烟 curl +# 直打 /api 反代未暴露)。2026-11-15 补齐:产物走容器/网关 nginx 的 /api 反代。 +VITE_API_BASE_URL=/api/v1 diff --git a/web/vite.config.ts b/web/vite.config.ts index b0e04150..cdacc6e0 100644 --- a/web/vite.config.ts +++ b/web/vite.config.ts @@ -22,6 +22,13 @@ export default defineConfig({ }, server: { port: 5173, + // sms.unimsc.com 外网测试通道(2026-11-15 用户裁定,统一域名入口): + // 经 nginx 根路径反代(443→5173)访问,Host 头为域名,vite5.4+ DNS-rebinding + // 防护默认只放行 localhost/内网 IP,须显式登记;ai.unimsc.com/SmsDev 前缀通道已废弃。 + allowedHosts: ['sms.unimsc.com'], + // HMR 经域名通道回流:wss://sms.unimsc.com/(443,nginx 已配 Upgrade 头)。 + // 静态配置取舍=域名优先;本机直连 :5173 时 HMR 退化为断连警告+手动刷新(功能无损)。 + hmr: { clientPort: 443 }, proxy: { // real 模式时代理到本地网关(S3 起 Mock 已下线,单一 real 通道)。 // 网关自 Day42 起按 configs/config.dev.yaml 稳定监听 :8080