From 3710e7866b76df3022967ac118533ae2834e46a7 Mon Sep 17 00:00:00 2001 From: zg Date: Thu, 16 Jul 2026 13:45:30 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=9D=E5=A7=8B=E5=8C=962?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- memory/MEMORY.md | 1 + memory/session-20260716-1.md | 61 ++++++++++++++++++++++++++++++++++++ 2 files changed, 62 insertions(+) create mode 100644 memory/session-20260716-1.md diff --git a/memory/MEMORY.md b/memory/MEMORY.md index a028977..6cd11fc 100644 --- a/memory/MEMORY.md +++ b/memory/MEMORY.md @@ -1,3 +1,4 @@ +- [会话 2026-07-16 #1](session-20260716-1.md) — 宝塔API返回HTML错误排查（根因：10.1.1.170公网IP变更，白名单过期） - [会话 2026-06-21 #2](session-20260621-2.md) — DNS解析API从10.1.1.160迁移至101.132.183.138:32210，Java后端改指新地址 - [会话 2026-06-21 #1](session-20260621-1.md) — 宝塔面板API接入，Nginx反代管理迁移至宝塔（只读），160 nginx废弃，前端只读改造 - [会话 2026-06-19 #1](session-20260619-1.md) — 审计字段全栈实现：创建人/更新人/时间 + 排序 + DNS本地审计表 + 数据库迁移 + 部署 diff --git a/memory/session-20260716-1.md b/memory/session-20260716-1.md new file mode 100644 index 0000000..74a3993 --- /dev/null +++ b/memory/session-20260716-1.md @@ -0,0 +1,61 @@ +--- +name: session-20260716-1 +description: 2026-07-16 第1次会话 — 宝塔API返回HTML错误排查（IP白名单变更） +metadata: + type: session + date: 2026-07-16 + sessionNumber: 1 + startTime: 2026-07-16T00:00:00+08:00 +--- + +# 2026-07-16 第1次会话 + +## 会话摘要 +排查 `/api/rules` 接口报错问题，确认根因是 10.1.1.170 出公网 IP 发生变化，宝塔面板白名单中仍是旧 IP `183.192.136.97`，导致宝塔拒绝请求返回 HTML 登录页。用户更新白名单后解决。 + +## 关键操作 + +### 1. 前端打包命令确认 +- **做了什么**: 查看了 `nginx-manager-frontend/package.json`，确认打包命令为 `npm run build`（执行 `vite build`） +- **结果**: 无单独的 prod 命令，`build` 默认即生产模式打包，输出到 `dist/` 目录 + +### 2. 宝塔API /api/rules 报错排查 +- **现象**: 前端访问 `https://gw.server.zgitm.com/api/rules` 报错: + ``` + 获取转发规则失败: 宝塔API请求失败: Could not extract response: + no suitable HttpMessageConverter found for response type + [java.util.Map] + and content type [text/html;charset=utf-8] + ``` +- **调用链路**: Vue前端 → Gateway → Java后端(10.1.1.170:4002) → btRestTemplate → 宝塔面板(101.132.183.138:18888) → 返回 text/html 而非 JSON +- **排查**: 阅读了 `BTPanelApiClient.java`、`ForwardingRuleService.java`、`ForwardingRuleController.java`、`RestTemplateConfig.java`、`application.yml`，确认代码逻辑没问题 +- **根因**: 10.1.1.170 出公网 IP 从 `183.192.136.97` 变成了新 IP，宝塔面板白名单拦截请求，返回 HTML 登录页 +- **解决**: 用户更新宝塔面板 IP 白名单后恢复正常 + +### 3. 可能原因分析（按可能性排序） +| 排名 | 原因 | 说明 | +|------|------|------| +| 1 | 宝塔面板服务挂了 | 138 上的宝塔面板进程崩溃，nginx 返回 HTML 错误页 | +| 2 | API Key 过期/失效 | 宝塔返回登录页 HTML | +| **3** | **IP 白名单变化** ✅ | **确认为此原因** | +| 4 | 宝塔面板端口变更 | 138:18888 端口改了 | + +## 重要信息 + +### 当前架构（无变化） +| 组件 | 机器 | 端口 | 说明 | +|------|------|------|------| +| Vue 前端 | 10.1.1.170 Docker | 3002 | Nginx转发管理/SSL/DNS | +| Java 后端 | 10.1.1.170 Docker | 4002 | 宝塔API接入 + 阿里云DNS | +| DNS Python API | 101.132.183.138 | 32210 | 阿里云DNS解析 | +| 宝塔面板 | 101.132.183.138 | 18888 | Nginx反代管理（API Key: ahv5RRcYm3Vi2PzEFvqYsZvsS8LeGkYp） | +| MySQL | 10.1.1.122 | 3306 | DNS审计 + 证书通知配置 | + +### 宝塔面板连接信息 +- 面板地址: https://101.132.183.138:18888 +- API Key: ahv5RRcYm3Vi2PzEFvqYsZvsS8LeGkYp +- ⚠️ IP 白名单需要与 10.1.1.170 实际出公网 IP 保持一致 + +## 改进建议 +- [ ] 考虑添加健康检查端点，主动监控宝塔 API 连通性 +- [ ] 考虑在 `BTPanelApiClient` 中增加响应 Content-Type 检测，当返回 HTML 时给出更友好的错误提示（而非 `HttpMessageConverter` 的底层错误）