超图服务地址配置说明

配置方式

超图服务地址现在支持通过环境变量配置，无需修改代码即可适配不同的部署环境。

配置文件位置

开发环境配置

文件：.env.development

VITE_SUPERMAP_HOST=localhost
VITE_SUPERMAP_PORT=8090

生产环境配置

文件：.env.production

VITE_SUPERMAP_HOST=106.15.124.118  # 修改为实际超图服务器地址
VITE_SUPERMAP_PORT=8090

自定义完整地址

如果需要使用完整的地址（例如包含域名或特定路径），可以在配置文件中添加：

VITE_SUPERMAP_BASE_URL=http://your-domain.com:8090

使用步骤

1. 开发环境

开发环境默认使用 localhost:8090，无需修改。

如果本地超图服务地址不同，修改 .env.development 文件：

VITE_SUPERMAP_HOST=192.168.1.100
VITE_SUPERMAP_PORT=8090

2. 生产环境部署

方式一：修改配置文件后打包

修改 .env.production 文件中的超图服务器地址
执行打包命令：npm run build:prod
将打包后的 dist 目录部署到服务器

方式二：打包后动态修改（不推荐） 打包后的配置是静态的，无法动态修改。建议使用方式一。

配置项说明

配置项	说明	默认值
`VITE_SUPERMAP_HOST`	超图服务器地址	localhost
`VITE_SUPERMAP_PORT`	超图服务器端口	8090
`VITE_SUPERMAP_BASE_URL`	完整的服务地址（可选）	http://${HOST}:${PORT}

影响的服务

以下服务地址会自动使用配置的超图服务器地址：

基础地理实体

建筑矢量瓦片
土壤矢量瓦片
河流矢量瓦片
流域矢量瓦片

公共服务

水下地形

注意

超图官方在线服务（如CBD、倾斜摄影等）仍然使用固定的在线地址，不受此配置影响。

验证配置

启动前端后，在浏览器控制台可以看到超图服务配置信息：

超图服务配置: { host: "106.15.124.118", port: "8090", baseUrl: "http://106.15.124.118:8090" }

不同环境配置示例

本地开发

VITE_SUPERMAP_HOST=localhost
VITE_SUPERMAP_PORT=8090

测试环境

VITE_SUPERMAP_HOST=192.168.1.100
VITE_SUPERMAP_PORT=8090

生产环境

VITE_SUPERMAP_HOST=supermap.example.com
VITE_SUPERMAP_PORT=8090

# 或使用完整地址
VITE_SUPERMAP_BASE_URL=http://supermap.example.com:8090

常见问题

Q: 修改配置后需要重新打包吗？

A: 是的。环境变量在打包时会被编译进代码，修改配置后需要重新执行 npm run build:prod。

Q: 可以在运行时动态修改吗？

A: 不可以。Vite的环境变量是静态配置，在打包时就已确定。如果需要动态配置，建议使用数据库存储服务地址。

Q: 如何确认配置生效？

A: 打开浏览器控制台，查看启动时打印的配置信息，或检查网络请求中的服务地址。

进阶：数据库动态配置（可选）

如果需要更灵活的动态配置，可以将服务地址存储在数据库中，通过后端API获取。实现方式：

在数据库表 watershed_service 中存储服务地址
前端启动时通过API获取配置
动态更新服务地址

这种方式可以实现无需重新打包即可修改配置，适合多租户或需要频繁修改的场景。

超图服务配置说明.md 3.4 KB Historik Rå