Java SaaS开源框架 —— 企业级云原生应用开发平台
在数字化转型加速的今天,企业对灵活、可扩展、低成本的软件交付模式需求日益迫切。SaaS(Software as a Service)作为云原生应用的核心范式,正深刻重塑企业软件的开发与交付方式。而Java,凭借其成熟生态、高稳定性与强大并发处理能力,始终是构建企业级SaaS平台的首选语言。
本项目致力于打造一套完整、可落地、高扩展的Java SaaS开源框架,覆盖从基础架构设计、多租户隔离、权限精细化控制、自动化部署到生态集成的全链路实践,为开发者提供“开箱即用”的参考实现与最佳实践指南。
框架基于Spring Boot 3.x + Spring Cloud Alibaba技术栈,深度融合Spring Security OAuth2、Redis分布式锁、Quartz任务调度、Elasticsearch全文检索等组件,构建出一套支持千万级租户规模、毫秒级响应、99.99%可用性的企业级SaaS平台底座。所有核心模块均遵循领域驱动设计(DDD)思想,采用六边形架构(Hexagonal Architecture)实现业务逻辑与技术实现的解耦,确保系统长期可维护性与演进能力。
为什么选择本框架?
- ⚡ 完整SaaS能力内建:租户注册/注销、配额管理、资源隔离、计费订阅等SaaS生命周期管理开箱即用;
- ⚙️ 高内聚低耦合架构:模块化设计(common/core/infra/tenant/auth/monitor),支持独立演进与替换;
- 🔒 多维租户隔离:支持Schema级、Table级、Field级三级隔离策略,动态切换;
- 🎨 权限模型灵活:RBAC+ABAC混合模型,支持角色继承、动态权限、数据权限(行级/列级);
- 🚀 云原生就绪:支持Kubernetes部署、Helm Chart一键安装、Prometheus+Grafana监控集成;
- 📝 文档与案例完备:提供架构图、部署手册、二次开发指南、实战Demo(租户管理、多语言、工作流引擎等)。
框架核心定位与价值主张
不止于“能跑”,更要“跑得稳、跑得远”
当前市场上的Java SaaS开源方案普遍存在三大痛点:一是架构轻量但功能残缺,仅支持简单多租户;二是过度依赖商业闭源组件,二次开发受限;三是文档简略,缺乏真实场景落地经验沉淀。本框架直面这些挑战,以“企业级可用性”为第一准则,构建起一套经受过生产环境验证的解决方案。
在架构设计上,我们摒弃了“大而全”的微服务分层陷阱,采用“服务内聚+能力外化”策略:核心租户、用户、权限模块以单体形式交付(降低运维复杂度),而日志、监控、消息等通用能力通过API网关统一接入,支持后期按需拆分为独立微服务。这种“渐进式演进”模式,既满足初创团队快速上线需求,又为大型企业长期扩展预留空间。
特别在多租户实现上,我们提出“三层租户画像模型”:基础层(租户基本信息)、能力层(功能模块启用状态)、数据层(租户专属配置与自定义字段)。通过该模型,系统可精准识别租户类型(如政府版/教育版/企业版),动态加载对应权限与UI,实现真正的“一租户一产品”体验。
技术选型深度说明
- 核心框架:Spring Boot 3.2+(支持Java 17+,全面拥抱虚拟线程与结构化并发);
- 服务治理:Nacos 2.2(服务发现+配置中心一体化)、Sentinel 1.8(流量防护);
- 安全体系:Spring Security + OAuth2 + JWT(支持JWT密钥轮换与短生命周期Token);
- 数据隔离:动态多数据源(ShardingSphere 5.x + MyBatis Plus插件);
- 缓存策略:Redis Cluster + 本地缓存(Caffeine),避免缓存击穿与雪崩;
- 日志可观测:ELK(Elasticsearch+Logstash+Kibana)或 Loki+Promtail+Grafana;
- CI/CD流水线:GitLab CI + Jenkins + Argo CD(支持GitOps模式);
- 前端集成:Vue 3 + Vite + Pinia + Ant Design Vue,提供完整后台模板。
所有依赖版本均经过严格兼容性测试,避免“版本地狱”。框架提供完整的依赖管理POM(parent POM),开发者引入后无需手动指定版本号,确保环境一致性。
整体架构设计:从单体到云原生的平滑演进
三层架构视图
框架采用“领域驱动+云原生”双轮驱动架构,分为三层:
- 应用层(Application Layer):以租户为边界,提供RESTful API与WebSocket实时通信。核心服务包括租户服务、用户服务、权限服务、消息服务。所有服务均实现“租户上下文自动注入”,开发者无需感知租户切换逻辑;
- 基础设施层(Infrastructure Layer):抽象为可插拔模块,包括数据访问(MyBatis Plus)、缓存(Redis)、消息队列(RocketMQ)、对象存储(MinIO)、日志(SLF4J+Logback)。支持通过配置文件动态切换实现;
- 平台层(Platform Layer):提供SaaS通用能力,如租户生命周期管理(注册/激活/冻结/注销)、配额监控(API调用次数/存储空间)、计费对接(支付宝/微信/银联沙箱环境)、审计日志(操作留痕+防篡改)。
架构图核心组件说明
| 组件 | 功能 | 技术方案 |
|---|---|---|
| 租户网关 | 路由+认证+限流 | Nginx + Lua脚本动态路由 + Sentinel规则热加载 |
| 动态多数据源 | 租户数据库绑定 | 自定义AbstractRoutingDataSource + ThreadLocal租户ID注入 |
| 权限引擎 | 实时权限校验 | Spring Security表达式扩展 + Redis缓存权限快照 |
| 租户注册中心 | 租户元数据管理 | Nacos Config + Spring Cloud LoadBalancer |
| 审计日志服务 | 操作记录存储 | 异步写入Elasticsearch + 自动索引生命周期管理(ILM) |
部署拓扑示例(生产环境)
典型部署采用“多地多活”架构:用户就近接入(CDN加速),核心应用部署于多个可用区(AZ),数据库主从+读写分离,配置中心与注册中心集群部署。关键链路如下:
- 用户请求 → 全球负载均衡(GSLB)→ 边缘节点(Edge Node)→ API网关集群;
- 网关解析租户ID → 调用Nacos获取租户数据库地址 → 路由至对应应用实例;
- 应用实例从Redis获取租户配置 → 执行业务逻辑 → 写入对应数据库;
- 关键操作触发事件 → 发送至RocketMQ → 异步执行审计/通知/计费;
- 所有日志 → 通过Filebeat采集 → 写入Elasticsearch集群。
该架构支持单租户故障隔离,不影响其他租户正常服务,满足金融级SLA要求。
多租户实现:从简单到高级的四种隔离策略
租户隔离的四种典型模式对比
| 隔离级别 | 数据隔离方式 | 成本 | 安全性 | 适用场景 |
|---|---|---|---|---|
| 1. 共享数据库 | 所有租户数据同库,通过tenant_id字段区分 | 最低 | 低(需严格校验) | 初创产品、测试环境 |
| 2. 共享Schema | 每个租户独立Schema,表结构一致 | 低 | 中 | 中小型企业SaaS |
| 3. 独立Schema | 租户专属数据库,支持自定义表结构 | 高 | 高 | 金融/医疗等强监管行业 |
| 4. 混合模式 | 核心数据独立库,非敏感数据共享库 | 中 | 高 | 大型平台型SaaS |
本框架推荐的混合隔离方案
我们采用“三级租户画像”驱动的动态隔离策略:
- 基础租户(如免费版):共享数据库 + tenant_id字段;
- 企业租户(如标准版):共享Schema + 租户专属Schema;
- 尊享租户(如定制版):独立数据库 + 租户专属Schema + 自定义字段扩展能力;
- 超级租户(如渠道商):独立数据库 + 子租户管理能力(租户嵌套)。
系统通过配置中心动态下发租户隔离策略,业务代码通过注解@TenantAware自动注入租户上下文,无需硬编码。例如:
@GetMapping("/list")
@TenantAware // 自动注入租户ID
public List listOrders(@RequestParam Long userId) {
return orderService.selectListByUserId(userId);
}
在数据访问层,框架通过MyBatis Plus的MetaObjectHandler自动注入tenant_id字段,确保所有SQL隐式包含租户条件,杜绝漏扫风险。
租户生命周期管理实践
租户从创建到注销的完整流程如下:
- 注册:用户提交信息 → 邮箱/短信验证 → 自动分配租户编号(UUID + 时间戳)→ 创建租户Schema/数据库;
- 初始化:导入默认模板(角色/菜单/字典)→ 生成初始配置(配额/阈值)→ 发送欢迎邮件;
- 运行:实时监控资源使用 → 触发预警(80%阈值)→ 自动扩容(K8s HPA);
- 升级/降级:支持按月/年订阅变更 → 差异数据迁移(使用Schema对比工具)→ 灰度生效;
- 冻结:欠费超7天 → 停止服务 → 保留数据30天;
- 注销:用户申请 → 人工审核 → 数据加密归档 → 30天后物理删除。
所有操作均记录在审计日志中,支持追溯。框架提供租户管理控制台(Tenant Admin Console),支持批量操作、数据快照、一键迁移等运维能力。
权限体系:RBAC+ABAC的融合模型
权限设计的三大核心问题
传统RBAC模型在复杂SaaS场景下存在明显局限:角色爆炸(100个角色×50个租户=5000个角色)、数据权限难实现、动态策略不支持。本框架提出“四维权限矩阵”模型:
- 一维:身份(用户/角色/部门/岗位);
- 二维:资源(菜单/按钮/API/数据表/字段);
- 三维:操作(增/删/改/查/导出/打印);
- 四维:数据范围(本人/本部门/本区域/全部/自定义SQL)。
动态权限配置示例
以“销售经理”角色为例,其权限配置如下:
- 菜单权限:客户管理、订单查询、业绩报表;
- API权限:GET /api/customers(全部)、POST /api/orders(仅本人创建)、DELETE /api/customers(本部门);
- 数据权限:客户列表 → “本区域”(SQL条件:region_id = #{currentRegion});
- 按钮权限:订单详情页 → 显示“修改”按钮(仅状态为“草稿”时);
- 字段权限:客户信息页 → 隐藏“客户等级”字段(对普通销售可见)。
所有权限配置通过前端可视化编辑器生成JSON,后端解析为Spring Security表达式,实时生效。支持租户管理员自定义角色,无需开发介入。
数据权限的实现细节
框架支持三种数据权限模式:
- 行级权限:通过SQL拦截器自动添加WHERE条件。例如:
SELECT * FROM customer WHERE owner_id = #{userId} OR dept_id IN (SELECT dept_id FROM dept_user WHERE user_id = #{userId}) - 列级权限:通过MyBatis插件动态修改SELECT字段列表。例如:
SELECT id, name, phone FROM customer WHERE ...(隐藏“客户等级”列) - 自定义权限:支持租户管理员编写SQL片段(模板引擎渲染),如“仅查看本季度数据”:
create_time >= #{quarterStart} AND create_time < #{quarterEnd}
所有权限校验均在Service层完成,避免Controller层绕过。框架提供@DataPermission注解,支持按方法粒度控制:
@GetMapping("/list")
@DataPermission(type = DataPermissionType.DEPARTMENT)
public List listUsers() {
return userService.list();
}
系统自动注入租户ID与当前用户部门ID,生成最终SQL。
DevOps实践:从代码提交到生产上线的全链路自动化
CI/CD流水线设计
框架提供完整的GitLab CI配置模板(.gitlab-ci.yml),覆盖以下阶段:
- Code Review:集成SonarQube静态检查(代码规范+漏洞扫描);
- Build:Maven构建 + Docker镜像打包(多阶段构建优化体积);
- Test:单元测试(JUnit 5)+ 接口测试(TestNG)+ UI测试(Playwright);
- Deploy:Helm Chart部署至K8s集群 + 金丝雀发布(10%流量);
- Verify:Prometheus监控指标检查(错误率<0.1%、P99延迟<200ms)→ 自动回滚。
配置中心动态管理
使用Nacos Config实现配置热更新,关键配置项包括:
- 租户隔离策略:tenant.isolation.strategy=schema|database
- 数据权限模板:data.permission.template=dept_or_self
- 限流规则:rate.limit.api=/api/*:1000
- 定时任务:job.cleanup.tenant.enabled=true
所有配置支持按租户ID覆盖(Tenant-Specific Config),实现差异化策略。例如:金融租户开启强审计,教育租户关闭支付模块。
日志与可观测性
框架集成OpenTelemetry标准,实现全链路追踪:
- 日志:JSON格式输出(含trace_id、span_id、tenant_id)→ Logstash解析 → Elasticsearch索引;
- 指标:Micrometer暴露Prometheus指标(http_requests_total、db_connection_active);
- 追踪:基于OpenTelemetry SDK,自动采集Span数据 → Jaeger UI可视化;
- 告警:Grafana Alerting规则 → 企业微信/钉钉机器人推送。
例如,租户API错误率突增时,系统自动发送告警并附带Top3慢SQL,加速问题定位。
生态集成:无缝对接主流企业级系统
第三方服务对接方案
⚡ 钉钉/企业微信集成
支持免登、组织架构同步、消息推送。通过@DingCallback注解自动校验签名,防止伪造请求。
⚙️ 支付宝/微信支付
封装统一支付接口(UnifiedPaymentService),支持订单查询、退款、对账。提供沙箱环境自动切换配置。
〔阿里云OSS〕
对象存储服务,支持断点续传、防盗链、图片处理(水印/缩略图)。租户专属Bucket命名规则:{tenantId}-bucket。
〈Elasticsearch〉
全文检索支持,租户数据独立索引(tenant_orders_2024)。提供自定义分词器(ik_smart/ik_max_word)。
工作流引擎集成(Activiti/Camunda)
框架提供流程引擎扩展模块,支持:
- 租户专属流程模板库(管理员可上传BPMN文件);
- 流程实例与租户绑定(act_re_deployment.deployment_scope = 'tenant');
- 自定义表单引擎(JSON Schema驱动,支持字段联动、校验规则);
- 流程监控(实时查看各租户流程执行情况、耗时热力图)。
示例:客户投诉流程 → 自动创建工单 → 分配至对应区域客服 → 超时未处理升级至经理 → 归档至知识库。
低代码平台对接
框架提供低代码扩展点:
- 表单设计器:基于Formily,支持拖拽生成前端表单;
- 数据源配置:租户可添加自定义数据库(JDBC URL + 密码加密存储);
- API聚合:支持将多个微服务接口编排为新API(GraphQL风格);
- 权限继承:租户管理员可继承平台级权限模板并微调。
某客户基于本框架3天内完成“员工请假系统”定制开发,降低90%编码工作量。
真实落地案例:从中小企业到大型集团
案例一:某SaaS CRM厂商(200人规模)
原系统基于单租户架构,新租户上线需2周开发+1周部署。切换至本框架后:
- 租户注册时间从2周缩短至10分钟(自动初始化Schema+模板数据);
- 权限配置错误率下降95%(可视化编辑器+实时预览);
- 年运维成本降低40%(统一监控+自动化部署);
- 支持1000+租户并发,平均响应时间180ms。
特别优化了多租户数据迁移工具,支持从旧系统CSV导出 → 智能字段映射 → 一键导入新租户库。
案例二:某省级政务云平台
需满足等保三级要求,框架实现:
- 租户数据物理隔离(独立数据库);
- 所有操作留痕(审计日志不可篡改);
- 密码策略强制(8位+大小写+特殊字符+定期更换);
- 数据加密(AES-GCM加密敏感字段,密钥由KMS管理);
- 支持国产化适配(麒麟OS+达梦数据库+达梦中间件)。
通过等保三级认证,成为政务SaaS标杆案例。
案例三:某跨国教育集团
需支持多语言、多币种、多时区:
- 租户配置项:locale=zh_CN/currency=CNY/timezone=Asia/Shanghai;
- 动态加载资源包(messages_zh_CN.properties);
- 汇率实时同步(接入央行API);
- 跨时区任务调度(Quartz时区感知插件)。
已服务全球37个国家,日均处理学生数据200万条。
开发者高频问题解答
Q1:框架对服务器资源要求高吗?
A:基础版(单租户):4核8G内存(JVM 4G)即可运行;生产版(1000+租户):推荐8核16G+Redis集群+MySQL主从。支持容器化部署,K8s可动态扩缩容。
Q2:如何平滑升级框架版本?
A:提供upgrade-tool模块,自动检测数据库结构变更(Flyway脚本)+ 配置迁移(Nacos Config Diff工具)。升级流程:
- 备份数据库;
- 拉取新版本代码;
- 执行Flyway脚本;
- 灰度发布(10%流量);
- 验证核心链路 → 全量上线。
Q3:是否支持私有化部署?
A:完全支持!提供私有化部署包(含离线Helm Chart),所有外部依赖(如Nacos)可替换为私有服务。支持国产化环境(统信UOS+达梦+东方通TongWeb)。
Q4:如何贡献代码?
A:欢迎提交PR!流程如下:
- Fork仓库;
- 创建特性分支(git checkout -b feature/new-module);
- 编写单元测试(覆盖率≥80%);
- 提交PR并关联Issue;
- 通过Code Review后合并。
详细规范见CONTRIBUTING.md。