# 2026-07-22

## VITE_API_URL 部署配置分析

**项目**：tuanwei-admin（广西医科大学团委智能化平台 - AI团宝）

### 三个 .env 文件当前配置
- `.env`（默认）：`VITE_API_URL=/api`（相对路径，配合 nginx 反代）
- `.env.development`：`VITE_API_URL=http://127.0.0.1:10051/api`（开发）
- `.env.production`：`VITE_API_URL=http://twai-api/api`（生产，依赖 nginx upstream 或 docker DNS）

### 部署后登录卡住：根因不是 API URL，而是数据库

**后端错误**：
```
java.sql.SQLSyntaxErrorException: Table 'tuanwei.sys_user' doesn't exist
```

**API URL 连通性实测**：
- ✅ `http://10.129.0.125:38927/api` 通，CORS 已正确配置（Access-Control-Allow-Origin: http://10.129.0.125）
- ❌ `http://127.0.0.1:38927/api` Connection refused（端口不在 127.0.0.1 上监听，Spring Boot 绑定可能是 0.0.0.0:38927）
- ✅ `http://twai-api/api` 取决于 nginx upstream 是否配置

**`docs/sql/` 三个文件均无 sys_user 建表脚本**：
- gxmu_college_class.sql
- gxmu_mysql.sql
- gxmu_declare_migration.sql

按用户记忆约定：sys_user 应归属 gxwebsoft_core 库（租户 ID 10582），但后端当前直查 tuanwei 库导致表不存在。

### 后续待办
1. 确认后端数据源（是否在 yml 里配了多数据源 / 切库）
2. 在后端让 sys_user 走 gxwebsoft_core 库，或在 tuanwei 库建 sys_user 表
3. 生产环境推荐 VITE_API_URL=/api + nginx 反代，避免 CORS 和端口暴露