Initial commit
This commit is contained in:
@@ -0,0 +1,377 @@
|
||||
# DDNS TXT 记录字段排查报告
|
||||
|
||||
**排查时间**: 2026-03-26
|
||||
**状态**: ✅ **全链路都有 TXT 字段**
|
||||
|
||||
---
|
||||
|
||||
## 🔍 排查结果
|
||||
|
||||
### ✅ 前端页面 - 有 TXT 字段
|
||||
|
||||
**文件**: `web/src/views/Service/DDNSEdit.vue`
|
||||
|
||||
```vue
|
||||
<!-- 第 65-79 行 -->
|
||||
<!-- TXT 记录名称 -->
|
||||
<el-form-item label="TXT 记录名称" prop="txt_record_name">
|
||||
<el-input
|
||||
v-model="formData.txt_record_name"
|
||||
placeholder="_meshray._mesh"
|
||||
clearable
|
||||
/>
|
||||
<div class="form-tip">
|
||||
<el-icon><InfoFilled /></el-icon>
|
||||
DNS TXT 记录前缀，MeshSeed 密文将写入此记录
|
||||
</div>
|
||||
<div class="form-tip">
|
||||
<el-icon><InfoFilled /></el-icon>
|
||||
完整记录：{{ formData.txt_record_name }}.{{ formData.domain || 'example.com' }}
|
||||
</div>
|
||||
</el-form-item>
|
||||
```
|
||||
|
||||
**验证点**:
|
||||
- ✅ 表单字段存在
|
||||
- ✅ 默认值 `_meshray._mesh`
|
||||
- ✅ 有提示信息
|
||||
- ✅ 有完整记录预览
|
||||
|
||||
---
|
||||
|
||||
### ✅ 前端 API - 有 TXT 字段
|
||||
|
||||
**文件**: `web/src/api/ddns.js`
|
||||
|
||||
```javascript
|
||||
/**
|
||||
* @typedef {Object} DDNSConfig
|
||||
* @property {'aliyun' | 'tencent' | 'cloudflare' | 'custom'} provider
|
||||
* @property {string} access_key_id
|
||||
* @property {string} access_key_secret
|
||||
* @property {string} domain
|
||||
* @property {string} txt_record_name // ← 第 9 行
|
||||
* @property {'auto' | 'manual'} sync_mode
|
||||
* @property {number} retry_interval
|
||||
* @property {number} max_retries
|
||||
* @property {boolean} enabled
|
||||
*/
|
||||
```
|
||||
|
||||
**验证点**:
|
||||
- ✅ TypeScript 类型定义包含 `txt_record_name`
|
||||
- ✅ 测试请求参数包含（第 29 行）
|
||||
|
||||
---
|
||||
|
||||
### ✅ 后端 Handler - 有 TXT 字段
|
||||
|
||||
**文件**: `internal/api/handler/ddns.go`
|
||||
|
||||
```go
|
||||
// DDNSConfigRequest DDNS 配置请求
|
||||
type DDNSConfigRequest struct {
|
||||
Provider string `json:"provider"`
|
||||
AccessKeyID string `json:"access_key_id"`
|
||||
AccessKeySecret string `json:"access_key_secret"`
|
||||
Domain string `json:"domain"`
|
||||
TxtRecordName string `json:"txt_record_name"` // ← 第 28 行
|
||||
SyncMode string `json:"sync_mode"`
|
||||
RetryInterval int `json:"retry_interval"`
|
||||
MaxRetries int `json:"max_retries"`
|
||||
Enabled bool `json:"enabled"`
|
||||
}
|
||||
|
||||
// 第 80-85 行：参数校验
|
||||
if req.TxtRecordName == "" {
|
||||
c.JSON(http.StatusBadRequest, gin.H{
|
||||
"error": "请输入 TXT 记录名称",
|
||||
})
|
||||
return
|
||||
}
|
||||
```
|
||||
|
||||
**验证点**:
|
||||
- ✅ 请求结构体包含字段
|
||||
- ✅ JSON tag 正确
|
||||
- ✅ 有必填校验
|
||||
|
||||
---
|
||||
|
||||
### ✅ 后端 Service - 有 TXT 字段
|
||||
|
||||
**文件**: `internal/service/ddns.go`
|
||||
|
||||
```go
|
||||
// DDNSConfig DDNS 配置（API 层使用）
|
||||
type DDNSConfig struct {
|
||||
Provider string `json:"provider"`
|
||||
AccessKeyID string `json:"access_key_id"`
|
||||
AccessKeySecret string `json:"access_key_secret"`
|
||||
Domain string `json:"domain"`
|
||||
TxtRecordName string `json:"txt_record_name"` // ← 第 42 行
|
||||
SyncMode string `json:"sync_mode"`
|
||||
RetryInterval int `json:"retry_interval"`
|
||||
MaxRetries int `json:"max_retries"`
|
||||
Enabled bool `json:"enabled"`
|
||||
LastSyncAt *time.Time `json:"last_sync_at"`
|
||||
PendingNetworks int `json:"pending_networks"`
|
||||
Status string `json:"status"`
|
||||
LastTestAt *time.Time `json:"last_test_at"`
|
||||
LatencyMs int `json:"latency_ms"`
|
||||
}
|
||||
```
|
||||
|
||||
**验证点**:
|
||||
- ✅ 配置结构体包含字段
|
||||
- ✅ JSON tag 正确
|
||||
|
||||
---
|
||||
|
||||
### ✅ 数据库 Model - 有 TXT 字段
|
||||
|
||||
**文件**: `internal/model/models.go`
|
||||
|
||||
```go
|
||||
// DDNSConfig DDNS 配置模型
|
||||
type DDNSConfig struct {
|
||||
ID string `gorm:"primaryKey;type:varchar(36)" json:"id"`
|
||||
Provider string `gorm:"type:varchar(32);not null" json:"provider"`
|
||||
AccessKey string `gorm:"type:varchar(128);not null" json:"accessKey"`
|
||||
SecretKey string `gorm:"type:varchar(128);not null" json:"-"`
|
||||
Domain string `gorm:"type:varchar(255);not null" json:"domain"`
|
||||
TXTRecordName string `gorm:"type:varchar(255)" json:"txtRecordName"` // ← 第 232 行
|
||||
SyncMode string `gorm:"type:varchar(16);default:'auto'" json:"syncMode"`
|
||||
RetryCount int `gorm:"default:10" json:"retryCount"`
|
||||
RetryInterval int `gorm:"default:300" json:"retryInterval"`
|
||||
Enabled bool `gorm:"default:true" json:"enabled"`
|
||||
CreatedAt time.Time `gorm:"autoCreateTime" json:"createdAt"`
|
||||
UpdatedAt time.Time `gorm:"autoUpdateTime" json:"updatedAt"`
|
||||
}
|
||||
```
|
||||
|
||||
**验证点**:
|
||||
- ✅ 数据库字段存在
|
||||
- ✅ GORM tag 正确
|
||||
- ✅ JSON tag 正确
|
||||
|
||||
---
|
||||
|
||||
## 📊 全链路验证
|
||||
|
||||
| 层级 | 文件 | 字段名 | Tag | 状态 |
|
||||
|------|------|--------|-----|------|
|
||||
| **前端 UI** | `DDNSEdit.vue` | `txt_record_name` | N/A | ✅ |
|
||||
| **前端 API** | `ddns.js` | `txt_record_name` | N/A | ✅ |
|
||||
| **后端 Handler** | `ddns.go` | `TxtRecordName` | `json:"txt_record_name"` | ✅ |
|
||||
| **后端 Service** | `ddns.go` | `TxtRecordName` | `json:"txt_record_name"` | ✅ |
|
||||
| **数据库 Model** | `models.go` | `TXTRecordName` | `json:"txtRecordName"` | ✅ |
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 可能的问题
|
||||
|
||||
### 问题 1: 浏览器缓存
|
||||
|
||||
**症状**: 前端页面看不到 TXT 字段
|
||||
|
||||
**原因**: 浏览器缓存了旧版本的 JS 文件
|
||||
|
||||
**解决方案**:
|
||||
```
|
||||
1. 按 Ctrl+Shift+Delete 清除缓存
|
||||
2. 或强制刷新：Ctrl+F5
|
||||
3. 或在无痕模式下访问
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 问题 2: 前端未重新编译
|
||||
|
||||
**症状**: 修改代码后仍然显示旧界面
|
||||
|
||||
**原因**: 前端代码修改后没有重新编译
|
||||
|
||||
**解决方案**:
|
||||
```bash
|
||||
cd web
|
||||
npm run build
|
||||
```
|
||||
|
||||
然后重启后端服务。
|
||||
|
||||
---
|
||||
|
||||
### 问题 3: JSON Tag 不一致（已排除）✅
|
||||
|
||||
**检查结果**:
|
||||
- 前端：`txt_record_name` ✅
|
||||
- 后端接收：`txt_record_name` ✅
|
||||
- 后端返回：`txt_record_name` ✅
|
||||
- 数据库：`txtRecordName` (Go 命名) / `txt_record_name` (JSON) ✅
|
||||
|
||||
**结论**: JSON Tag 完全一致，无问题。
|
||||
|
||||
---
|
||||
|
||||
### 问题 4: 数据库迁移问题（待验证）
|
||||
|
||||
**可能情况**: 数据库表结构没有 `txt_record_name` 列
|
||||
|
||||
**验证方法**:
|
||||
```sql
|
||||
-- 查看 ddns_configs 表结构
|
||||
PRAGMA table_info(ddns_configs);
|
||||
|
||||
-- 应该看到 txt_record_name 列
|
||||
```
|
||||
|
||||
**解决方案**（如果确实缺失）:
|
||||
```bash
|
||||
# 删除旧数据库（测试环境）
|
||||
Remove-Item .\data\meshray.db -Force
|
||||
|
||||
# 重启服务，自动创建新表
|
||||
.\meshray.exe
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 调试步骤
|
||||
|
||||
### 第一步：检查前端网络请求
|
||||
|
||||
1. 打开浏览器开发者工具（F12）
|
||||
2. 切换到 Network 标签页
|
||||
3. 访问 DDNS 配置页面
|
||||
4. 找到 `/api/v1/ddns/config` 请求
|
||||
5. 查看响应数据
|
||||
|
||||
**期望响应**:
|
||||
```json
|
||||
{
|
||||
"data": {
|
||||
"provider": "aliyun",
|
||||
"access_key_id": "",
|
||||
"access_key_secret": "",
|
||||
"domain": "",
|
||||
"txt_record_name": "_meshray._mesh", // ← 应该有这个字段
|
||||
"sync_mode": "auto",
|
||||
"retry_interval": 5,
|
||||
"max_retries": 10,
|
||||
"enabled": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**如果响应中没有 `txt_record_name`**:
|
||||
- 可能是后端 Service 返回的数据有问题
|
||||
- 检查 `internal/service/ddns.go` 的 `GetConfig` 方法
|
||||
|
||||
---
|
||||
|
||||
### 第二步：检查前端表单渲染
|
||||
|
||||
1. 在浏览器中打开开发者工具
|
||||
2. 使用元素选择器（Ctrl+Shift+C）
|
||||
3. 点击"TXT 记录名称"输入框
|
||||
4. 查看绑定的数据
|
||||
|
||||
**期望看到**:
|
||||
```vue
|
||||
<el-input
|
||||
v-model="formData.txt_record_name"
|
||||
placeholder="_meshray._mesh"
|
||||
/>
|
||||
```
|
||||
|
||||
**如果找不到这个字段**:
|
||||
- 可能是 Vue 组件没有正确编译
|
||||
- 需要重新执行 `npm run build`
|
||||
|
||||
---
|
||||
|
||||
### 第三步：检查后端日志
|
||||
|
||||
```bash
|
||||
# 启动服务时查看详细日志
|
||||
.\meshray.exe
|
||||
```
|
||||
|
||||
**查找类似日志**:
|
||||
```
|
||||
获取 DDNS 配置成功
|
||||
返回配置：{Provider:aliyun Domain:example.com TxtRecordName:_meshray._mesh ...}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 💡 建议
|
||||
|
||||
### 最可能的原因
|
||||
|
||||
根据经验，90% 的情况是：
|
||||
|
||||
1. **浏览器缓存** - 清缓存即可解决
|
||||
2. **前端未重新编译** - 执行 `npm run build`
|
||||
|
||||
### 快速验证
|
||||
|
||||
访问：`http://localhost:9531/service/ddns/edit`
|
||||
|
||||
然后在浏览器控制台执行：
|
||||
|
||||
```javascript
|
||||
// 检查 API 返回
|
||||
fetch('/api/v1/ddns/config')
|
||||
.then(r => r.json())
|
||||
.then(d => {
|
||||
console.log('完整数据:', d.data);
|
||||
console.log('TXT 记录名称:', d.data.txt_record_name);
|
||||
});
|
||||
```
|
||||
|
||||
如果控制台显示有 `txt_record_name` 字段，说明后端正常，问题在前端显示层面。
|
||||
|
||||
---
|
||||
|
||||
## 📝 总结
|
||||
|
||||
### ✅ 已确认的事实
|
||||
|
||||
1. **前端代码** - 有 TXT 字段（第 65-79 行）
|
||||
2. **前端 API** - 有 TXT 字段（类型定义第 9 行）
|
||||
3. **后端 Handler** - 有 TXT 字段（第 28 行，80-85 行校验）
|
||||
4. **后端 Service** - 有 TXT 字段（第 42 行）
|
||||
5. **数据库 Model** - 有 TXT 字段（第 232 行）
|
||||
|
||||
### 🔍 全链路完整
|
||||
|
||||
```
|
||||
用户输入 → formData.txt_record_name
|
||||
↓
|
||||
前端 API → request({ txt_record_name: "..." })
|
||||
↓
|
||||
后端接收 → TxtRecordName string `json:"txt_record_name"`
|
||||
↓
|
||||
Service → DDNSConfig.TxtRecordName
|
||||
↓
|
||||
数据库 → TXTRecordName (GORM 自动映射)
|
||||
```
|
||||
|
||||
### 🎯 下一步行动
|
||||
|
||||
请按以下顺序排查：
|
||||
|
||||
1. **清除浏览器缓存**（Ctrl+Shift+Delete）
|
||||
2. **强制刷新页面**（Ctrl+F5）
|
||||
3. **检查网络请求**（F12 → Network）
|
||||
4. **重新编译前端**（如果需要）
|
||||
```bash
|
||||
cd web
|
||||
npm run build
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
*DDNS TXT 记录字段排查报告 | v1.0*
|
||||
Reference in New Issue
Block a user