# 平台更新功能 - 问题修复记录

## ❌ 原始错误

### 前端错误信息
```
获取数据失败：SyntaxError: Unexpected token '<', "<!doctype "... is not valid JSON
```

### 错误原因分析

1. **路径不匹配**：
   - 前端请求：`/api/platform/upgrade/list`
   - Vite 代理配置：只代理 `/platform/*` 和 `/backend/*` 路径
   - 后端路由：注册在 `/api/platform/upgrade/list`

2. **请求被重定向到 404 页面**：
   - 由于 `/api/*` 没有被代理，请求直接访问前端开发服务器（端口 4000）
   - 找不到对应路由，返回 HTML 格式的 404 页面
   - 前端尝试解析 HTML 为 JSON，导致语法错误

## ✅ 解决方案

### 修改前端请求路径

**文件**: `platform/src/views/platform/platformupgrade/index.vue`

**修改前**:
```javascript
const response = await fetch(`/api/platform/upgrade/list?limit=${pageSize.value * 2}`);
```

**修改后**:
```javascript
const response = await fetch(`/platform/api/upgrade/list?limit=${pageSize.value * 2}`);
```

### 路径映射说明

```
前端请求：/platform/api/upgrade/list
    ↓
Vite 代理 (vite.config.js)
    ↓
转发到：http://127.0.0.1:9000/platform/api/upgrade/list
    ↓
Beego 路由匹配
    ↓
实际路由：/api/platform/upgrade/list  ← 注意路径顺序不同！
```

## 🔧 需要调整的地方

当前方案存在路径不一致的问题。为了保持路径统一，有两种方案：

### 方案一：修改后端路由（推荐）

**文件**: `go/routers/api/api.go`

将路由从 `/api/platform/upgrade/list` 改为 `/platform/api/upgrade/list`：

```go
// 修改前
beego.Router("/api/platform/upgrade/list", &controllers.ApiPlatformUpgradeController{}, "get:List")
beego.Router("/api/platform/upgrade/detail", &controllers.ApiPlatformUpgradeController{}, "get:Detail")

// 修改后
beego.Router("/platform/api/upgrade/list", &controllers.ApiPlatformUpgradeController{}, "get:List")
beego.Router("/platform/api/upgrade/detail", &controllers.ApiPlatformUpgradeController{}, "get:Detail")
```

**优点**: 
- 前后端路径完全一致
- 便于维护和理解

### 方案二：保持现有路由，前端使用完整路径

如果后端服务已经部署且无法修改路由，前端可以这样写：

```javascript
// 生产环境：直接使用完整 URL
const API_BASE_URL = import.meta.env.VITE_API_BASE_URL || 'http://localhost:9000';
const response = await fetch(`${API_BASE_URL}/api/platform/upgrade/list?limit=${pageSize.value * 2}`);
```

**缺点**:
- 开发环境和生产环境配置复杂
- 不利于本地调试

## 📝 后续建议

1. **统一路径规范**：
   - 建议采用方案一，统一使用 `/platform/api/*` 路径结构
   - 所有 Platform 相关接口都以此前缀开头

2. **添加错误处理**：
   ```javascript
   const response = await fetch(`/platform/api/upgrade/list?limit=${pageSize.value * 2}`);
   
   // 检查响应状态
   if (!response.ok) {
     throw new Error(`HTTP error! status: ${response.status}`);
   }
   
   // 检查是否是 JSON 格式
   const contentType = response.headers.get('content-type');
   if (!contentType?.includes('application/json')) {
     const text = await response.text();
     console.error('非 JSON 响应:', text.substring(0, 200));
     throw new Error('API 返回非 JSON 格式');
   }
   
   const result = await response.json();
   ```

3. **环境变量配置**：
   创建 `.env.development` 和 `.env.production` 文件：
   ```env
   # .env.development
   VITE_API_BASE_URL=http://127.0.0.1:9000
   
   # .env.production
   VITE_API_BASE_URL=https://your-domain.com
   ```

## 🚀 立即测试步骤

1. **确保数据库已初始化**：
   ```sql
   -- 执行 SQL 脚本
   source docs/sql/platform_upgrade.sql
   ```

2. **重启后端服务**：
   ```bash
   cd go
   bee run
   ```

3. **启动前端服务**：
   ```bash
   cd platform
   npm run dev
   ```

4. **访问管理页面**：
   - 登录系统
   - 访问：`http://127.0.0.1:4000/platform/platformupgrade`
   - 应该能看到示例数据

5. **查看官网首页展示**：
   - 访问官网首页
   - 滚动到"近期平台更新内容"区域
   - 应该能看到 3 条示例更新记录

---

**修复时间**: 2026-09-18  
**修复内容**: 修正前端 API 请求路径  
**影响范围**: Platform 管理平台页面