切换后端

前端 不区分 Java 单体、Java 微服务还是 Python，只通过 VITE_API_BASE_URL 指向 API 根地址。

配置方式

Web

在 packages/web 下创建或修改 .env.development：

# 推荐：留空，走 Vite 代理（见 frontend/web.md）
VITE_API_BASE_URL=

后端	地址	说明
server-java（单体）	留空或 http://localhost:8080	单体自带 CORS
micro-java（经 Gateway）	留空（推荐）或 http://localhost:8080	直连须 Gateway GatewayCorsConfig
server-python	http://localhost:8000	或自定义 --port 8080

micro-java 与 server-java 端口相同

两者对外都是 8080，不能同时占用。切换时停掉另一个后端即可。Web 开发推荐 VITE_API_BASE_URL 留空走代理，三种 Java/Python 后端均适用。

Desktop

packages/desktop/.env.development 同样配置 VITE_API_BASE_URL。

Mobile

在 packages/mobile/ 下配置（勿只改 .env.example）：

场景	文件
H5 / 开发	.env.development
App 打包 / 生产	.env.production

VITE_API_BASE_URL=http://192.168.1.12:8080

读取：src/config/index.ts → getApiBaseUrl()。App 真机须用局域网 IP 或公网地址。修改后需重新 build:app-android 并重新打 APK。

契约对齐要求

三个后端必须实现相同的：

• 路径：/api/v1/auth/login、/api/v1/system/users 等
• JSON 字段：camelCase（accessToken、pageSize）
• 响应格式：{ code, message, data }
• 权限码：system:*、monitor:* 等（与 seed / OpenAPI 一致）
• 401 / 403 中文错误信息

详见 契约层概览。

对比测试建议

1. 用同一套 Web 前端
2. 分别指向 Java 单体 8080、micro-java Gateway 8080、Python 8000
3. 验证：登录、菜单、用户 CRUD、无权限 403

相关文档

• Mobile 环境变量
• Java 单体概览
• micro-java 微服务
• Python 概览