From 3a47363a6c60ad50a3cbcb0aa50375d051487c0f Mon Sep 17 00:00:00 2001 From: admin <572701190@qq.com> Date: Mon, 4 May 2026 02:43:49 +0800 Subject: [PATCH] =?UTF-8?q?2026-05-04-02-38-48=20=E8=AE=B0=E5=BD=95?= =?UTF-8?q?=E5=B7=A5=E4=BD=9C=E6=B5=81=E6=89=A7=E8=A1=8C=E9=AA=8C=E8=AF=81?= =?UTF-8?q?=E7=BB=93=E6=9E=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 工程分析/测试方案-2026-05-04-02-38-48.md | 11 +++++ 工程分析/经验记录.md | 54 ++++++++++++++++++++++++ 2 files changed, 65 insertions(+) diff --git a/工程分析/测试方案-2026-05-04-02-38-48.md b/工程分析/测试方案-2026-05-04-02-38-48.md index 81644ae..607c515 100644 --- a/工程分析/测试方案-2026-05-04-02-38-48.md +++ b/工程分析/测试方案-2026-05-04-02-38-48.md @@ -47,6 +47,17 @@ npm run dev - 添加远程仓库 `origin`。 - 推送到 Gitea。 +## 执行结果 + +- `npm ci` 执行成功，未发现 npm audit 漏洞。 +- `npm run build` 执行成功。 +- 构建出现 Vite 大 chunk 警告，当前不影响本次文档基线。 +- `3000` 端口已被 `/home/wkmgc/Desktop/Seg_Server` 的 node 服务占用。 +- 本项目改用 `3001` 端口部署。 +- 使用 `tmux` 会话 `revoxelseg-dicom` 托管 Vite 开发服务。 +- `curl -I http://127.0.0.1:3001/` 返回 `HTTP/1.1 200 OK`。 +- 文档已推送到 Gitea `main` 分支。 + ## 人工审核状态 - 本文档用于建立工作流基线。 diff --git a/工程分析/经验记录.md b/工程分析/经验记录.md index cf5e494..f18c7de 100644 --- a/工程分析/经验记录.md +++ b/工程分析/经验记录.md @@ -19,3 +19,57 @@ C. 解决问题方案 D. 后续如何避免问题 每次项目修改前先记录时间戳并阅读 `工程分析/工程整体分析.md` 与 `工程分析/经验记录.md`。修改前写入需求、实现和测试文档，确认后再执行，完成后追加经验记录并提交 Gitea 备份。 + +## 2026-05-04-02-38-48 Gitea 推送后的本地凭据清理 + +A. 具体问题 + +使用带账号信息的一次性推送地址完成 Gitea push 后，本地 `branch.main.remote` 曾记录为带账号信息的 URL。 + +B. 产生问题原因 + +`git push -u main` 会把该 `` 记录为当前分支上游，而不是只使用已配置的 `origin` 名称。 + +C. 解决问题方案 + +将 `origin` 保持为不含账号信息的仓库地址，并把 `branch.main.remote` 改回 `origin`、`branch.main.merge` 改为 `refs/heads/main`。 + +D. 后续如何避免问题 + +后续推送时优先使用已配置好的 `origin`。如果必须临时带认证信息推送，推送后立即检查 `git config --get-regexp 'branch\\.main|remote\\.origin'`，确保本地配置中没有保存账号密码。 + +## 2026-05-04-02-38-48 开发服务端口占用 + +A. 具体问题 + +本项目默认 Vite 端口 `3000` 已被 `/home/wkmgc/Desktop/Seg_Server` 的 node 服务占用，无法直接作为本项目部署端口。 + +B. 产生问题原因 + +同一机器上已有其他项目服务监听 `0.0.0.0:3000`。 + +C. 解决问题方案 + +不停止既有服务，改用 `3001` 端口启动当前项目的 Vite 服务，并通过 `curl -I http://127.0.0.1:3001/` 验证返回 `HTTP/1.1 200 OK`。 + +D. 后续如何避免问题 + +部署前先使用 `ss -ltnp` 检查目标端口。如果默认端口被占用，优先选择相邻可用端口并在测试方案执行结果中记录实际访问地址。 + +## 2026-05-04-02-38-48 后台部署进程托管 + +A. 具体问题 + +使用普通 `nohup` 后台启动 Vite 时进程会静默退出，无法稳定保留服务。 + +B. 产生问题原因 + +当前命令执行环境会回收普通后台子进程，导致 `nohup` 方式没有形成稳定部署。 + +C. 解决问题方案 + +使用 `tmux new-session -d -s revoxelseg-dicom` 托管 Vite 服务，使开发服务脱离当前命令执行会话独立运行。 + +D. 后续如何避免问题 + +需要保留长时间运行的开发服务时，优先使用 `tmux` 会话托管，并用 `tmux capture-pane -pt ` 查看启动日志，用 `curl` 验证 HTTP 响应。