You need to enable JavaScript to run this app. 使用Javascript在前端配置适配多环境的Base URL(开发/API/生产)
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.19 17:36:03