uni-app 一个域名下部署多个应用方案解析

一、技术背景与需求分析

在uni-app跨平台开发场景中，企业常面临多应用部署的挑战：独立域名成本高、维护复杂，而单域名多应用部署可显著降低资源消耗。典型场景包括：

企业级应用矩阵：主应用+管理后台+数据看板共用域名
SaaS多租户系统：不同客户应用通过路径区分
营销活动组合：主站与多个H5活动页面共享域名

核心需求点：路径隔离、独立更新、权限控制、性能优化。技术实现需兼顾uni-app的跨端特性（H5/小程序/App）与Web服务器的路由能力。

二、核心实现方案

方案1：基于路径的子目录部署

技术原理：通过Web服务器配置将不同应用映射到域名子路径，如：

https://example.com/app1 → 应用A
https://example.com/app2 → 应用B

实现步骤：

前端配置：
- 修改manifest.json中的H5配置：
```
"h5": {
"router": {
  "base": "/app1/"  // 设置应用基础路径
},
"publicPath": "/app1/"  // 静态资源路径
}
```
- 确保所有资源引用（JS/CSS/图片）使用相对路径或配置后的publicPath

服务器配置（Nginx示例）：

location /app1/ {
  alias /path/to/app1/dist/;
  try_files $uri $uri/ /app1/index.html;
}
location /app2/ {
  alias /path/to/app2/dist/;
  try_files $uri $uri/ /app2/index.html;
}

优势：配置简单，适合独立开发的应用
挑战：需处理跨应用Cookie隔离、静态资源缓存冲突

方案2：微前端架构集成

技术原理：将uni-app作为子应用嵌入主框架，通过JS沙箱实现隔离

实现要点：

主框架设计：

使用qiankun或single-spa等微前端库

配置子应用入口：

registerMicroApps([
{
  name: 'app1',
  entry: '//example.com/app1/',
  container: '#subapp-container',
  activeRule: '/app1'
}
]);

uni-app适配：

修改main.js导出生命周期：

export async function bootstrap() {
console.log('app1 bootstrap');
}
export async function mount(props) {
// 渲染逻辑
}
export async function unmount() {
// 卸载逻辑
}

配置vue.config.js输出UMD格式：

module.exports = {
configureWebpack: {
  output: {
    library: `app1`,
    libraryTarget: 'umd'
  }
}
}

优势：动态加载、独立版本控制
挑战：增加架构复杂度，需处理样式隔离、通信机制

方案3：多页面应用(MPA)模式

技术原理：在单个uni-app项目中配置多页面入口

实现步骤：

配置pages.json：

{
  "pages": [
    {
      "path": "pages/app1/index",
      "style": { "navigationBarTitleText": "应用A" }
    },
    {
      "path": "pages/app2/index",
      "style": { "navigationBarTitleText": "应用B" }
    }
  ],
  "subPackages": [
    {
      "root": "packageA",
      "pages": [...]
    }
  ]
}

路由控制：

通过中间页实现路径跳转：

// 在入口文件判断路径
const path = window.location.pathname;
if (path.startsWith('/app1')) {
uni.reLaunch({ url: '/pages/app1/index' });
}

优势：单项目维护，共享公共代码
局限：H5端需配合服务器重定向，小程序端受平台限制

三、关键问题解决方案

1. 静态资源路径处理

问题：子目录部署时资源404
解决方案：

配置vue.config.js的publicPath：

module.exports = {
  publicPath: process.env.NODE_ENV === 'production' 
    ? `/app1/` 
    : '/'
}

使用<base>标签（仅H5）：
```
<base href="/app1/">
```

2. 跨应用通信

场景：主应用与子应用数据交互
实现方案：

使用postMessage API：

// 主应用发送
window.parent.postMessage({
  type: 'APP_SWITCH',
  data: { target: 'app2' }
}, '*');
// 子应用接收
window.addEventListener('message', (e) => {
  if (e.data.type === 'APP_SWITCH') {
    // 处理逻辑
  }
});

或通过全局状态管理（如Vuex）

3. 性能优化策略

实施要点：

代码分割：

// vue.config.js
module.exports = {
  configureWebpack: {
    optimization: {
      splitChunks: {
        chunks: 'all'
      }
    }
  }
}

预加载：

<link rel="preload" href="/app1/js/chunk-vendors.js" as="script">

服务端缓存：

location /app1/ {
  expires 1y;
  add_header Cache-Control "public";
}

四、部署架构示例

典型拓扑：

用户请求 → CDN边缘节点 → Nginx负载均衡 → 
  ├── 应用A容器（/app1/）
  ├── 应用B容器（/app2/）
  └── 静态资源服务

CI/CD流程：

各应用独立构建：

# 应用A构建
UNI_APP_BASE=/app1/ npm run build:h5
# 应用B构建
UNI_APP_BASE=/app2/ npm run build:h5

自动部署到对应目录
Nginx配置热更新

五、安全与监控

安全措施：

路径验证：

// 中间件验证
app.use((req, res, next) => {
  if (!/^\/(app1|app2)\//.test(req.path)) {
    return res.status(403).send('Forbidden');
  }
  next();
});

CSP策略：

add_header Content-Security-Policy "default-src 'self' example.com";

监控方案：

应用性能监控（APM）：

// 集成Sentry
import * as Sentry from '@sentry/browser';
Sentry.init({ dsn: 'YOUR_DSN' });

日志分离：

location /app1/ {
  access_log /var/log/nginx/app1.access.log;
}

六、最佳实践建议

开发阶段：
- 使用环境变量区分部署路径
- 建立统一的脚手架工具
测试阶段：
- 实施跨应用接口测试
- 验证路径切换的边界情况
运维阶段：
- 制定独立的回滚方案
- 监控各应用的资源使用

进阶方案：对于超大规模应用，可考虑：

容器化部署（Docker+K8s）
服务网格架构（Istio）
边缘计算节点部署

通过合理选择上述方案，开发者可在uni-app框架下实现高效的多应用部署，平衡开发效率与运维成本。实际项目中，建议根据团队技术栈、应用复杂度及长期维护成本进行综合评估。