2026-04-29-22-37-36 - 修复登录ERR_CONNECTION_REFUSED：前端baseURL改IP+后端CORS扩origin

工程分析/实现方案-2026-04-29-22-37-36.md

@@ -0,0 +1,46 @@
+# 实现方案 - 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 分钟