# 实现方案 - 2026-04-29-22-37-36

## 对应需求
- 需求分析文档: `需求分析-2026-04-29-22-37-36.md`

## 方案概述
服务器实际 IP 为 `192.168.3.11`。修复方案分三步：
1. 前端 `api.ts` 的 `baseURL` 改为服务器实际 IP
2. 后端 CORS 配置添加服务器 IP 对应的前端 origin
3. 重启前后端服务验证

## 根因分析
```
用户浏览器 → 访问 http://192.168.3.11:3000（前端）
         ↓ 前端代码运行
         ↓ api.ts 中 axios.post('http://localhost:8000/api/auth/login')
         ↓ 浏览器解析 localhost = 用户本地机器（非服务器）
         ↓ 用户本地 8000 端口无服务
         ↓ ERR_CONNECTION_REFUSED
```

## 修改文件清单

### 文件 1: `src/lib/api.ts`（修改）
- **修改类型**: 修改 baseURL
- **修改内容**: `http://localhost:8000` → `http://192.168.3.11:8000`

### 文件 2: `backend/config.py`（修改）
- **修改类型**: 扩展 CORS origins
- **修改内容**: `cors_origins` 从 `["http://localhost:3000"]` 扩展为 `["http://localhost:3000", "http://192.168.3.11:3000"]`

### 文件 3: `.env.example`（新增/修改）
- **修改类型**: 新增 VITE_API_BASE_URL 示例
- **修改内容**: 提供前端 baseURL 环境变量模板

## 新增依赖
无

## 兼容性分析
- localhost:3000 开发方式仍可用（CORS 双 origin）
- 局域网 IP 访问方式新增可用
- 回滚策略: 改回 localhost 即可

## 预估工作量
- 代码修改: 5 分钟
- 重启验证: 5 分钟