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),开发者引入后无需手动指定版本号,确保环境一致性。

整体架构设计:从单体到云原生的平滑演进

三层架构视图

框架采用“领域驱动+云原生”双轮驱动架构,分为三层:

  1. 应用层(Application Layer):以租户为边界,提供RESTful API与WebSocket实时通信。核心服务包括租户服务、用户服务、权限服务、消息服务。所有服务均实现“租户上下文自动注入”,开发者无需感知租户切换逻辑;
  2. 基础设施层(Infrastructure Layer):抽象为可插拔模块,包括数据访问(MyBatis Plus)、缓存(Redis)、消息队列(RocketMQ)、对象存储(MinIO)、日志(SLF4J+Logback)。支持通过配置文件动态切换实现;
  3. 平台层(Platform Layer):提供SaaS通用能力,如租户生命周期管理(注册/激活/冻结/注销)、配额监控(API调用次数/存储空间)、计费对接(支付宝/微信/银联沙箱环境)、审计日志(操作留痕+防篡改)。

架构图核心组件说明

组件功能技术方案
租户网关路由+认证+限流Nginx + Lua脚本动态路由 + Sentinel规则热加载
动态多数据源租户数据库绑定自定义AbstractRoutingDataSource + ThreadLocal租户ID注入
权限引擎实时权限校验Spring Security表达式扩展 + Redis缓存权限快照
租户注册中心租户元数据管理Nacos Config + Spring Cloud LoadBalancer
审计日志服务操作记录存储异步写入Elasticsearch + 自动索引生命周期管理(ILM)

部署拓扑示例(生产环境)

典型部署采用“多地多活”架构:用户就近接入(CDN加速),核心应用部署于多个可用区(AZ),数据库主从+读写分离,配置中心与注册中心集群部署。关键链路如下:

  1. 用户请求 → 全球负载均衡(GSLB)→ 边缘节点(Edge Node)→ API网关集群;
  2. 网关解析租户ID → 调用Nacos获取租户数据库地址 → 路由至对应应用实例;
  3. 应用实例从Redis获取租户配置 → 执行业务逻辑 → 写入对应数据库;
  4. 关键操作触发事件 → 发送至RocketMQ → 异步执行审计/通知/计费;
  5. 所有日志 → 通过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隐式包含租户条件,杜绝漏扫风险。

租户生命周期管理实践

租户从创建到注销的完整流程如下:

  1. 注册:用户提交信息 → 邮箱/短信验证 → 自动分配租户编号(UUID + 时间戳)→ 创建租户Schema/数据库;
  2. 初始化:导入默认模板(角色/菜单/字典)→ 生成初始配置(配额/阈值)→ 发送欢迎邮件;
  3. 运行:实时监控资源使用 → 触发预警(80%阈值)→ 自动扩容(K8s HPA);
  4. 升级/降级:支持按月/年订阅变更 → 差异数据迁移(使用Schema对比工具)→ 灰度生效;
  5. 冻结:欠费超7天 → 停止服务 → 保留数据30天;
  6. 注销:用户申请 → 人工审核 → 数据加密归档 → 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表达式,实时生效。支持租户管理员自定义角色,无需开发介入。

数据权限的实现细节

框架支持三种数据权限模式:

  1. 行级权限:通过SQL拦截器自动添加WHERE条件。例如: SELECT * FROM customer WHERE owner_id = #{userId} OR dept_id IN (SELECT dept_id FROM dept_user WHERE user_id = #{userId})
  2. 列级权限:通过MyBatis插件动态修改SELECT字段列表。例如: SELECT id, name, phone FROM customer WHERE ...(隐藏“客户等级”列)
  3. 自定义权限:支持租户管理员编写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工具)。升级流程:

  1. 备份数据库;
  2. 拉取新版本代码;
  3. 执行Flyway脚本;
  4. 灰度发布(10%流量);
  5. 验证核心链路 → 全量上线。

Q3:是否支持私有化部署?

A:完全支持!提供私有化部署包(含离线Helm Chart),所有外部依赖(如Nacos)可替换为私有服务。支持国产化环境(统信UOS+达梦+东方通TongWeb)。

Q4:如何贡献代码?

A:欢迎提交PR!流程如下:

  1. Fork仓库;
  2. 创建特性分支(git checkout -b feature/new-module);
  3. 编写单元测试(覆盖率≥80%);
  4. 提交PR并关联Issue;
  5. 通过Code Review后合并。

详细规范见CONTRIBUTING.md。