Vue.js多租户场景如何根据租户域名动态配置请求base URL与Axios配置?
Vue多租户子域名场景下动态匹配API基础路径实现
现存问题梳理
- 后端技术栈为Django + DRF,已经实现基于子域名的多租户能力,API访问规则为
{租户标识}.{主域名}/api/{具体接口},例如tenant1.sitename.com/api/endpoint、tenant2.sitename.com/api/endpoint - 前端已经开发完成可通用的Vue.js代码,原设计思路为同一份前端代码复用于所有租户,由后端识别域名对应的租户后返回同一份前端资源,降低维护成本
- 当前的实际bug为Axios配置硬编码了固定的租户API地址:
导致无论用户访问哪个租户的域名,前端所有接口请求都会固定发送到tenant1对应的后端服务,完全无法匹配当前访问页面对应的租户数据,和预期的「访问t1.foo.com自动请求t1.foo.com/api、访问t2.foo.com自动请求t2.foo.com/api」的效果存在偏差。// main.ts 中原有的硬编码配置 axios.defaults.baseURL = 'http://tenant1.mysite.local:8000/api/'; axios.defaults.withCredentials = true;
实现方案
不需要额外维护租户和域名的映射表,也不需要修改TypeScript的核心业务逻辑,依托浏览器端的原生location对象就可以实现完全动态的路径匹配:
替换硬编码的Axios基础配置
直接把main.ts中的固定baseURL替换为基于当前页面访问源动态生成的逻辑:
// 移除原有硬编码的baseURL,替换为如下代码 // 直接读取当前页面的源地址(协议+域名+端口,例如访问t2.foo.com:8080/home时,值为http://t2.foo.com:8080) const currentPageOrigin = window.location.origin; // 按照后端API的路径规则拼接基础地址,自动匹配当前租户 axios.defaults.baseURL = `${currentPageOrigin}/api/`; // 保留原有跨域携带凭证的配置,适配租户的cookie认证逻辑 axios.defaults.withCredentials = true;
这个逻辑的核心是:前端本身就运行在对应租户的子域名下,浏览器拿到的当前源地址天然就是对应当前租户的域名,拼接/api后缀之后,生成的API地址和后端的租户API规则完全一致,不需要前端自行解析识别租户标识。
部署层适配
针对不同租户域名正常访问前端的需求,不需要为每个租户单独部署前端实例:
- 所有租户子域名的DNS解析指向同一台前端静态资源服务器(或者同一套后端的静态资源处理目录)
- 后端Django的路由规则中,针对所有租户子域名的根路径请求,统一返回同一份Vue构建后的index.html入口文件,用户访问任何租户域名时加载的都是完全相同的前端代码,零额外维护成本。
落地注意事项
- 本地开发适配:通过本地hosts配置不同租户子域名做开发测试时,动态拼接的逻辑可以直接生效,不需要单独写开发环境的固定地址
- 生产环境HTTPS部署时,
window.location.origin会自动读取当前页面的安全协议,生成的API地址会自动适配https规则,不需要手动修改协议头 - 不需要额外写子域名解析的逻辑(比如手动截取域名前缀判断租户),动态拼接的逻辑会天然适配后续新增的任意租户,前端代码不需要做任何修改
内容的提问来源于stack exchange,提问作者illevens
相关产品推荐
相关产品推荐

