# 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*
