从独立部署到统一管理:SaaS 平台的前端工程架构设计
一、从一个实际项目场景出发
在传统项目开发中,通常一个业务系统对应一套前端工程。项目内部包含登录、菜单、路由、权限、业务组件等功能,前端只需要围绕当前项目进行开发和维护。
但当一个项目逐渐发展成 SaaS 平台时,情况就会发生变化。
例如,一个面向企业用户的 SaaS 平台,可能同时包含:
- 项目协作管理系统
- CRM 客户关系管理系统
- ERP 企业资源管理系统
- 数据分析与可视化系统
- 行业垂直业务系统
- 第三方合作系统
这些系统可能由不同团队开发,采用不同的技术栈,部署在不同服务器上,甚至有些系统本身已经具备完整的登录、菜单和权限体系。
这时候,如果仍然按照传统的单体项目方式组织前端工程,就会出现很多问题:
- 不同业务项目重复开发登录、菜单和权限功能。
- 公共组件无法有效共享,多个项目之间容易出现版本不一致。
- 不同业务项目的发布和升级相互影响。
- 第三方系统难以融入现有平台。
- 用户需要在不同系统之间重复登录。
- 平台无法统一管理不同业务应用的访问入口。
因此,我们需要重新思考前端工程的组织方式。
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 和图片资源请求路径错误。
这种方式有几个明显的优点:
- 不需要额外维护微前端运行时。
- 不同技术栈可以独立存在。
- 业务应用之间的运行环境相互隔离。
- 一个业务应用升级,不需要重新构建其他应用。
- 第三方系统也可以通过相同的方式接入。
因此,对于大多数 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 产品类型,从前端工程视角出发,逐步探索一套从产品设计、平台基础能力到前端工程架构的完整设计思路。本文更多是结合实际项目场景进行的架构思考,欢迎大家交流不同的落地经验,补充和完善前端工程生态。