外网测试通道改独立域名 sms.unimsc.com(2026-11-15 用户裁定): vite server.allowedHosts 登记域名(修 nginx 反代 403 Blocked)+hmr.clientPort=443(域名通道 HMR 经 nginx Upgrade 头回流;本机直连 HMR 退化为手动刷新,静态取舍域名优先)+新增 web/.env.production(VITE_API_BASE_URL=/api/v1)——修 S3 隐藏缺陷:build 不读 .env.development 致 dist 产物 API base 缺失;ai.unimsc.com/SmsDev 前缀通道废弃(前缀反代下资源绝对路径错位无干净解);铁律存档 activeContext+techContext;验证=Host 头模拟域名 200(未登记域名仍 403 防护保持)/本机 200/API proxy 401/四件套 148 全绿+build 产物含 api/v1 零域名残留;用户侧待办:DNS A 记录+certbot 签证书+nginx 贴 server 块 reload

This commit is contained in:
2026-11-15 11:37:53 +08:00
parent 2088c1c65f
commit d8a77f120c
4 changed files with 13 additions and 1 deletions
+1
View File
@@ -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 落地。 - **六项裁决速查(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。 - 归档仓(只读):/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 用户裁定)。 - **【铁律】测试端口固定=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 文件即残留可径删。 - **本会话教训**:①明细雪花 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 分支已生效,排查须看全量输出)。 - **历史运维教训**:①`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 分支已生效,排查须看全量输出)。
+1 -1
View File
@@ -38,7 +38,7 @@
| MinIO | 19010/19011(API/Console) | | | MinIO | 19010/19011(API/Console) | |
| Prometheus+Alertmanager | — | 规则 `deploy/monitoring/alert_rules.yml` | | 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)。
## 常用命令 ## 常用命令
+4
View File
@@ -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
+7
View File
@@ -22,6 +22,13 @@ export default defineConfig({
}, },
server: { server: {
port: 5173, 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: { proxy: {
// real 模式时代理到本地网关(S3 起 Mock 已下线,单一 real 通道)。 // real 模式时代理到本地网关(S3 起 Mock 已下线,单一 real 通道)。
// 网关自 Day42 起按 configs/config.dev.yaml 稳定监听 :8080 // 网关自 Day42 起按 configs/config.dev.yaml 稳定监听 :8080