(三)从独立部署到统一管理:SaaS 平台的前端工程架构设计

0 阅读16分钟

从独立部署到统一管理:SaaS 平台的前端工程架构设计

一、从一个实际项目场景出发

在传统项目开发中,通常一个业务系统对应一套前端工程。项目内部包含登录、菜单、路由、权限、业务组件等功能,前端只需要围绕当前项目进行开发和维护。

但当一个项目逐渐发展成 SaaS 平台时,情况就会发生变化。

例如,一个面向企业用户的 SaaS 平台,可能同时包含:

  • 项目协作管理系统
  • CRM 客户关系管理系统
  • ERP 企业资源管理系统
  • 数据分析与可视化系统
  • 行业垂直业务系统
  • 第三方合作系统

这些系统可能由不同团队开发,采用不同的技术栈,部署在不同服务器上,甚至有些系统本身已经具备完整的登录、菜单和权限体系。

这时候,如果仍然按照传统的单体项目方式组织前端工程,就会出现很多问题:

  1. 不同业务项目重复开发登录、菜单和权限功能。
  2. 公共组件无法有效共享,多个项目之间容易出现版本不一致。
  3. 不同业务项目的发布和升级相互影响。
  4. 第三方系统难以融入现有平台。
  5. 用户需要在不同系统之间重复登录。
  6. 平台无法统一管理不同业务应用的访问入口。

因此,我们需要重新思考前端工程的组织方式。

SaaS 前端工程架构的核心,不是把所有业务代码集中到一个项目中,而是让不同业务应用能够独立开发、独立部署,同时接受平台统一管理。

二、重新划分前端应用的职责

在设计工程架构之前,首先需要明确不同应用的职责。

我倾向于将整个前端体系划分为三个部分。

1. 主应用:统一门户

主应用不直接承载所有业务功能,而是作为整个平台的统一入口。

主要负责:

  • 用户登录与身份认证
  • 租户和组织切换
  • 应用菜单和导航管理
  • 用户可访问应用展示
  • 应用注册与加载
  • 主题和全局配置
  • 统一消息与通知

主应用更像是一个应用管理中心,而不是一个庞大的业务系统。

2. 业务应用:独立运行

每个业务系统拥有自己的前端工程。

例如:

  • 项目管理应用使用 Vue 开发。
  • 数据分析应用使用 React 开发。
  • 设备管理应用使用 Vue 开发。
  • 第三方业务系统使用自身技术栈。

业务应用负责自身的业务路由、页面状态、业务组件和数据交互。

它们可以独立构建、独立部署,不需要依赖主应用才能启动。

3. 平台服务:统一管理

前端主应用和各业务应用共享平台提供的基础服务。

例如:

  • 统一认证服务
  • 用户与组织服务
  • 租户管理服务
  • 应用注册服务
  • 权限管理服务
  • 全局配置服务

需要注意,这些服务应该由后端提供。前端主要负责接收配置、展示功能以及执行交互层面的权限控制。

三、独立部署:不一定需要微前端

这是我认为整个架构中最值得讨论的地方。

很多人在设计多应用前端架构时,会第一时间想到微前端。

但实际上,微前端并不是实现多应用独立部署的必要条件。

假设现在有三个业务系统:

  • 主应用:SaaS Portal
  • 业务应用 A:项目管理
  • 业务应用 B:数据分析
  • 业务应用 C:第三方设备管理

我们完全可以让它们分别构建和部署:

SaaS Platform
│
├── Portal
│   └── https://saas.example.com/
│
├── Project
│   └── https://saas.example.com/project/
│
├── Analytics
│   └── https://saas.example.com/analytics/
│
└── Device
    └── https://device.example.com/

通过 Nginx 或网关进行路径转发。

1. Nginx 部署配置

例如:

server {
    listen 80;
    server_name saas.example.com;

    location / {
        proxy_pass http://portal;
    }

    location /project/ {
        proxy_pass http://project-app;
    }

    location /analytics/ {
        proxy_pass http://analytics-app;
    }
}

这里的 portal、project-app 和 analytics-app 分别代表不同的上游服务。

实际部署时,还需要处理 SPA 的静态资源路径和前端路由回退。

以 Vue + Vite 项目为例:

// vite.config.ts

export default defineConfig({
  base: '/project/'
})

如果使用 Vue Router 的 History 模式:

const router = createRouter({
  history: createWebHistory('/project/'),
  routes
})

Nginx 对应配置:

location /project/ {
    proxy_pass http://project-app;
}

location /project/assets/ {
    proxy_pass http://project-app;
}

如果由 Nginx 直接托管静态文件,则需要为项目单独配置根目录和路由回退:

location /project/ {
    alias /var/www/project/;
    index index.html;
    try_files $uri $uri/ /project/index.html;
}

这里需要注意:如果使用 alias,静态文件目录必须和构建产物路径对应;如果使用反向代理,则应该由上游静态服务器处理 SPA 回退,避免不同应用错误地回退到主应用的 index.html。

每个业务应用还需要正确设置自己的资源 base,否则容易出现 JS、CSS 和图片资源请求路径错误。

这种方式有几个明显的优点:

  1. 不需要额外维护微前端运行时。
  2. 不同技术栈可以独立存在。
  3. 业务应用之间的运行环境相互隔离。
  4. 一个业务应用升级,不需要重新构建其他应用。
  5. 第三方系统也可以通过相同的方式接入。

因此,对于大多数 SaaS 平台而言,我更倾向于先采用独立 SPA 部署模式。

当业务确实需要无刷新切换、共享页面布局或者跨应用运行时通信时,再考虑引入微前端。

独立部署解决的是工程和发布边界,微前端解决的是运行时组合问题,两者并不是同一个概念。

四、建立统一应用注册中心

当业务应用越来越多,主应用就不能再通过硬编码的方式管理每一个业务系统。

例如:

const applications = [
  {
    name: '项目管理',
    path: '/project/'
  },
  {
    name: '数据分析',
    path: '/analytics/'
  }
]

这种方式适用于少量固定应用,但随着业务增加,主应用需要不断修改代码、重新构建和发布。

更合理的方式是建立应用注册中心。

由后端维护应用信息,主应用通过 API 获取当前用户可访问的应用列表。

例如:

{
  "appId": "project-management",
  "name": "项目管理",
  "type": "standalone",
  "entry": "/project/",
  "authMode": "oidc",
  "enabled": true,
  "version": "1.0.0"
}

第三方应用则可以采用:

{
  "appId": "device-platform",
  "name": "设备管理",
  "type": "iframe",
  "entry": "https://device.example.com",
  "authMode": "oidc",
  "enabled": true,
  "version": "2.0.0"
}

主应用只需要根据应用类型和访问地址完成对应的导航处理。

应用注册中心可以进一步管理:

  • 应用标识和名称
  • 应用访问地址
  • 应用接入类型
  • 应用版本
  • 应用启用状态
  • 租户可用应用
  • 应用所需权限
  • 应用运行时配置

新增业务应用时,原则上只需要完成应用注册和接入配置,不需要频繁修改主应用的业务代码。

需要强调的是,应用注册配置只描述应用元信息,不能代替后端的授权判断。

五、统一配置:让业务应用感知平台环境

独立部署之后,另一个问题随之出现:

业务应用如何知道当前登录用户、租户以及平台配置?

如果每个业务应用都独立维护这些信息,就会产生大量重复逻辑。

这里可以设计一个统一的运行时配置接口。

例如:

{
  "user": {
    "id": "10001",
    "name": "管理员"
  },
  "tenant": {
    "id": "tenant-001",
    "name": "企业 A"
  },
  "platform": {
    "theme": "dark",
    "language": "zh-CN"
  },
  "application": {
    "appId": "project-management",
    "version": "1.0.0"
  }
}

业务应用启动时,根据当前登录会话向平台获取对应配置。

这里有两个设计原则:

第一,业务应用不应该直接依赖主应用的内存状态。

第二,租户、用户等上下文应该由服务端根据当前认证会话确认,不能直接相信前端传递过来的租户 ID。

对于主题、语言等非敏感配置,可以通过运行时配置动态下发;对于权限和身份信息,则应该通过认证及授权服务获取。

这样即使业务应用独立部署,也可以感知当前 SaaS 平台的运行环境。

六、统一身份认证:解决多个应用重复登录的问题

多个业务应用独立部署后,身份认证就成为一个关键问题。

如果每个应用都有自己的登录体系,用户就需要在不同业务系统之间重复登录。

这时候需要引入 SSO(单点登录)。

可以采用 OAuth 2.0 / OpenID Connect 标准协议,由统一认证服务负责身份认证。

1. 认证流程

推荐使用 OAuth 2.0 Authorization Code + PKCE 流程。

基本过程如下:

用户访问业务应用 A
       │
       ▼
检查当前应用登录会话
       │
       ▼
发现未登录
       │
       ▼
跳转统一认证中心
       │
       ▼
检查认证中心登录状态
       │
       ├── 已登录:直接授权
       │
       └── 未登录:完成用户登录
       │
       ▼
返回业务应用 A 的回调地址
       │
       ▼
业务应用完成授权码兑换
       │
       ▼
建立业务应用自己的登录会话
       │
       ▼
进入业务页面

当用户再访问业务应用 B 时,也会经过相同的认证中心。

由于认证中心已经存在登录会话,通常不需要用户再次输入账号密码,就能完成新的应用授权。

2. 不同应用不应该简单共享 Token

这里容易产生一个误区:

既然用户已经在主应用登录了,能不能直接把主应用的 Token 传给其他业务应用?

我认为不应该这样设计。

更合理的方式是:

  • 认证中心负责统一用户身份。
  • 每个业务应用拥有独立的 OIDC Client。
  • 每个应用拥有自己的回调地址。
  • 每个应用独立完成授权码兑换。
  • 每个应用建立自己的安全会话。

对于浏览器 SPA,可以采用 Authorization Code + PKCE;对于更强调凭证保护的系统,可以采用 BFF(Backend For Frontend)模式,由应用后端负责保存和管理 Token,浏览器只持有安全的会话 Cookie。

如果多个应用部署在同一主域下,可以利用认证中心的登录会话减少重复登录,但不应该为了共享登录而让所有业务应用直接共享同一个会话凭证。

对于跨域应用,需要正确处理 OIDC 重定向、Cookie 的 SameSite 属性以及浏览器第三方 Cookie 限制。

3. 统一退出登录

退出登录也需要统一考虑。

例如:

用户退出主应用
       │
       ▼
通知认证中心结束会话
       │
       ▼
认证中心处理注销
       │
       ▼
各业务应用根据注销机制
清理自己的本地会话

如果采用 BFF 模式,可以由各应用服务端清理对应的会话 Cookie。

实际项目中可以结合 OIDC 的 RP-Initiated Logout、Front-Channel Logout 或 Back-Channel Logout 机制设计。

需要注意,统一退出不是简单清除主应用的 localStorage,因为其他应用可能仍然存在独立的服务端会话。

七、统一权限:平台管理,业务执行

身份认证解决的是用户是谁,权限管理解决的是用户能够做什么。

在 SaaS 平台中,权限需要进一步拆分。

1. 先区分三种不同的管理关系

这是应用注册、租户授权和用户权限最容易混淆的地方。

第一层:应用注册

回答的是:平台中有哪些应用?

例如:

应用注册中心
├── 项目管理
├── 数据分析
├── CRM
└── 设备管理

这属于平台级应用元数据管理。

第二层:租户应用授权

回答的是:某个企业购买或者启用了哪些应用?

例如:

租户 A
├── 项目管理:已启用
├── 数据分析:已启用
├── CRM:未启用
└── 设备管理:已启用

这属于 SaaS 产品订阅、应用授权和租户配置。

第三层:用户角色权限

回答的是:某个用户在已经启用的应用中可以做什么?

例如:

用户:张三
租户:企业 A

项目管理
├── 项目查看
├── 项目编辑
└── 项目删除

数据分析
├── 报表查看
└── 报表导出

这属于用户、角色和权限关系管理。

三层关系不能混为一谈。

一个应用注册成功,不代表所有租户都能使用;一个租户购买了应用,也不代表租户内的所有用户都拥有全部操作权限。

2. 权限获取流程

业务应用启动时,可以通过统一权限服务获取当前用户在当前租户下的应用权限。

例如:

{
  "appId": "project-management",
  "tenantId": "tenant-001",
  "permissions": [
    "project:view",
    "project:edit"
  ],
  "menus": [
    "project-list",
    "project-detail"
  ]
}

前端根据返回的权限标识控制菜单、路由和操作按钮。

例如:

const canEdit = permissions.includes('project:edit')

if (canEdit) {
  showEditButton()
}

这里的权限数据可以缓存,但需要考虑租户切换、角色变化和权限撤销后的失效问题。

3. 前端权限与后端权限的边界

需要特别强调:

前端权限控制只是用户体验层面的控制,不能作为真正的安全边界。

例如,用户虽然看不到项目删除按钮,但仍然可能通过直接调用 API 尝试删除项目。

因此,业务后端必须在每次请求时,根据当前认证身份、租户、资源和操作重新验证权限。

数据权限也应该由后端执行,不能依赖前端传递的租户 ID 或组织 ID 来保证隔离。

平台统一管理权限规则,业务服务负责最终授权执行。

八、第三方系统:采用 iframe 作为低成本接入方式

实际 SaaS 项目中,不可能所有业务都由自己开发。

可能会接入合作方系统、历史项目,甚至其他厂商已经成熟的业务平台。

这类系统如果强行改造成微前端,改造成本往往比较高。

因此可以采用 iframe 作为独立应用接入方式。

<iframe
  src="https://device.example.com"
  width="100%"
  height="100%"
  frameborder="0"
></iframe>

主应用负责:

  • 应用入口和访问控制
  • iframe 加载与卸载
  • 页面容器和布局
  • 必要的跨应用通信

第三方应用负责:

  • 自身业务页面
  • 身份认证
  • 业务权限
  • 数据交互

如果需要通信,可以通过 postMessage:

const iframe = document.querySelector('iframe')

iframe?.contentWindow?.postMessage(
  {
    type: 'TENANT_CHANGED',
    tenantId: 'tenant-001'
  },
  'https://device.example.com'
)

第三方应用接收消息时:

window.addEventListener('message', (event) => {
  if (event.origin !== 'https://saas.example.com') {
    return
  }

  if (event.source !== window.parent) {
    return
  }

  const message = event.data

  if (message.type === 'TENANT_CHANGED') {
    // 重新获取当前租户对应的业务数据
  }
})

实际使用时,还应该验证消息结构、消息类型和业务上下文。

不要直接把长期 Access Token 放在 URL 参数中,也不要通过普通 postMessage 随意传递长期凭证。

如果第三方支持统一认证,可以通过标准 SSO 协议完成身份接入。

如果第三方不支持,则需要保留独立登录或者由双方开发安全的认证适配方案。

这里需要明确:iframe 是一种接入和隔离手段,并不会自动解决身份认证和权限统一问题。

九、最终工程架构

经过前面的设计,可以形成一套相对简单的 SaaS 前端工程体系:

SaaS Platform
│
├── Portal 主应用
│   ├── 用户登录
│   ├── 应用中心
│   ├── 租户切换
│   ├── 菜单管理
│   └── 全局配置
│
├── Business Applications
│   ├── Project App(Vue)
│   ├── Analytics App(React)
│   └── CRM App(Vue)
│
├── Third-party Applications
│   ├── Device Platform(iframe)
│   └── External System(iframe)
│
└── Platform Services
    ├── Auth Service
    ├── Application Registry
    ├── Tenant Service
    ├── Permission Service
    └── Configuration Service

工程层面,各个应用可以独立开发、构建和部署。

平台层面,通过统一应用注册、身份认证和权限管理实现统一管理。

技术层面,不强制所有应用使用相同的前端框架,也不强制所有应用都接入微前端。

十、总结

我认为,SaaS 前端工程架构最重要的不是追求技术上的统一,而是建立合理的应用边界。

不同业务应用可以独立存在,甚至使用不同技术栈、不同部署环境,但它们应该遵循统一的平台接入规范。

主应用负责统一入口,平台服务负责统一管理,业务应用负责自身功能。

在这种架构下:

  • 独立部署解决应用之间的工程边界。
  • 应用注册解决业务系统的接入管理。
  • 统一配置解决平台上下文传递。
  • SSO 解决不同应用之间的身份认证。
  • 统一权限体系解决租户、应用和用户的授权关系。
  • iframe 和微前端解决不同应用的运行时接入问题。

微前端只是可选的运行时集成方案,而不是整个 SaaS 平台的基础前提

架构设计的最终目的,不是让所有项目都按照同一种方式开发,而是让不同项目能够在统一的平台规则下独立演进。

关于本文的一点思考

本文并不是为了提供一套标准化的前端工程架构,也不意味着上述方案适用于所有项目。

不同公司的业务规模、团队组成、技术积累、产品形态和交付模式都存在差异。即使面对相似的业务需求,最终采用的技术方案也可能完全不同。

本文更多是结合实际 SaaS 项目场景,对前端工程架构的一些问题进行拆解和思考,希望通过不同方案的分析,为实际项目开发提供一些设计思路和方案启发。

架构没有绝对正确的标准答案,只有在当前业务条件下更合适的选择。

我们不应该为了使用某项新技术而引入复杂架构,也不应该因为某种方案已经成为行业主流,就不加思考地照搬。

真正有价值的研发,不是机械地实现需求,也不是简单地堆叠技术,而是能够理解业务问题、分析实际约束、权衡不同方案,最终设计出最适合当前项目的解决方案。

不做没有思考的研发,不为技术而技术,让技术真正服务于业务。


专栏初衷:围绕自己熟悉的 SaaS 产品类型,从前端工程视角出发,逐步探索一套从产品设计、平台基础能力到前端工程架构的完整设计思路。本文更多是结合实际项目场景进行的架构思考,欢迎大家交流不同的落地经验,补充和完善前端工程生态。