使用Javascript在前端配置适配多环境的Base URL(开发/API/生产)
适配多场景的Base URL配置方案
以下方案覆盖前端、后端、开发、部署全场景需求:
方案1:动态推导Base URL(前端最省心方案,无需硬编码)
完全不用预设任何域名、协议、端口,自动适配当前运行环境:
- 核心逻辑直接读取当前页面的运行环境参数拼接,适配所有访问场景
- 代码示例(JS/TS 通用):
const getBaseUrl = () => { const protocol = window.location.protocol // 自动取http/https const host = window.location.host // 自动包含域名/IP+端口 const appPath = '/your-app-subpath' // 部署在子目录时填,根目录部署留空 return `${protocol}//${host}${appPath}` }
- 优势:开发、测试、生产环境代码完全不用修改,自动适配localhost、自定义端口、线上真实域名所有场景
- 注意:仅适用于浏览器端运行的前端项目,服务端渲染、跨端场景不适用
方案2:环境变量注入(前后端通用,最灵活)
把Base URL拆分到不同环境的专属配置文件,构建/启动时自动加载对应配置:
- 开发环境配置文件(.env.development)示例:
BASE_URL=http://localhost:8080/api
- 测试环境配置文件(.env.test)示例:
BASE_URL=https://test.your-domain.com/api
- 生产环境配置文件(.env.production)示例:
BASE_URL=https://prod.your-domain.com/api
- 使用时直接读取环境变量即可,比如JS中的
process.env.BASE_URL,Java中的@Value("${base-url}") - 额外适配技巧:如果要实现协议自动适配,可以把协议头去掉写成
//your-domain.com/api,浏览器会自动匹配当前页面的http/https协议
方案3:反向代理适配(部署端兜底方案)
如果前后端部署在同一个域名下,完全不用写完整Base URL:
- 所有接口请求统一加
/api前缀 - 在Nginx等反向代理服务中配置转发规则,把
/api开头的请求转发到对应的后端服务:
location /api/ { proxy_pass http://your-backend-service-addr/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }
- 这种场景下前端Base URL直接写
/api即可,不用关心协议、域名、端口,所有场景全部通用
通用注意事项
- 不要在业务代码里硬编码
http://、localhost或者固定端口,后续切换环境修改成本极高还容易漏改 - 对接第三方接口时,统一把第三方域名放到环境变量管理,不要散落在各个业务代码中
- 本地开发需要对接测试/生产接口时,直接修改本地开发环境的环境变量即可,不用改动业务代码
内容的提问来源于stack exchange,提问作者Shamsail
相关产品推荐
相关产品推荐

