在微服务与前后端分离盛行的今天，RESTful API 已成为系统集成的核心纽带。然而，开发一个安全、可审计、带权限控制的 API 接口，往往需要大量样板代码：Controller 层、Service 层、DAO 层、参数校验、权限拦截、日志记录……更别提还要维护 Swagger 文档和复杂的 RBAC（基于角色的访问控制）体系。

有没有一种方式，能让我们只写 SQL，就自动生成完整、安全、可调用的 API？

答案是：有！而且它完全开源、免费、遵循 Apache-2.0 协议——这就是由 Dromara 社区推出的 Surpass API 权限开放平台。

Surpass 是一个面向企业级场景的 统一 API 权限管理平台。它的核心理念非常激进却又实用：零代码开发，SQL 定义RESTful OpenAPI 接口。

你没看错——你只需要在管理后台写一条标准 SQL（支持 MyBatis 语法），Surpass 就能自动为你生成：

• 可直接调用的 HTTP RESTful 接口

• 自动生成的 Swagger 在线文档

• 基于 JWT 的无状态认证

• 细粒度的 RBAC 权限控制（用户 → 角色 → 应用 → 资源）

• 完整的调用日志与审计追踪

• 动态密钥加密与 Token 刷新机制

这意味着，过去需要数小时甚至数天才能完成的接口开发+权限配置工作，现在几分钟内即可上线。

GitHub/Gitee 上已有 3.4K Stars、1.4K Forks，被纳入 GVP（Gitee 最有价值开源项目），足见其在开发者社区中的热度与认可度。

效果展示

1、仪表盘

虽然“SQL 转 API”是最大亮点，但 Surpass 的真正价值在于构建了一套完整的 API 生命周期治理体系。

1. 零代码 OpenAPI 生成

开发者只需在 Web 界面中配置：

• 接口路径（如 /api/user/list）

• HTTP 方法（GET/POST 等）

• 对应的 SQL 语句（支持动态参数 #{userId}）

• 返回字段映射

系统即自动生成可调用的 API，并同步更新 Swagger 文档。前端同事再也不用等后端“联调”，直接看文档就能开发。

2. 企业级权限模型：RBAC + 客户端隔离

Surpass 内置经典的 四层权限模型：

• 用户（User）：系统操作者

• 角色（Role）：权限集合

• 应用（Application）：代表一个业务系统或客户端

• 资源（Resource）：即具体的 API 接口

通过灵活配置，你可以实现：

• “财务角色只能访问财务模块的 API”

• “移动端客户端无法调用后台管理接口”

• “某用户临时授权访问特定数据”

所有权限策略均可在 UI 上可视化配置，无需改代码。

3. 安全加固：JWT + 动态密钥 + 操作监控

• 所有 API 调用需携带合法 JWT Token

• Token 支持自动刷新，避免频繁登录

• 客户端 Secret 动态加密存储

• 用户操作行为全程记录，包括 IP、归属地、请求参数等

  
  

4. 全链路可观测性

Surpass 提供详细的 API 调用日志面板，支持按时间、用户、客户端、接口路径等维度筛选，便于问题排查与安全审计。

Surpass 采用主流技术栈构建：

• 后端：Java 17 + Spring Boot

• 前端：Vue 3 + TypeScript

• 数据库：MySQL 8.4.2+

得益于良好的模块化设计，项目结构清晰，二次开发门槛低。官方提供 Docker 一键部署脚本，本地启动仅需：

假设你是一家 SaaS 公司的后端工程师，需要为三个客户定制不同的数据查询接口：

• 客户 A：需要按部门统计员工数量

• 客户 B：需要导出近 30 天订单明细

• 客户 C：需要实时查看库存预警

传统做法：为每个客户写独立 Controller + Service + Mapper + 权限注解 + Swagger 注释……至少 1-2 天。

使用 Surpass：

1、创建三个“应用”（对应三个客户）

2、分别配置三条 SQL：

sql

3、为每个应用分配对应角色权限

4、完成！三个安全、独立、带文档的 API 已上线。

节省 90% 开发时间，且后续维护成本趋近于零。

Surpass 的出现，代表了一种趋势：基础设施能力下沉，业务逻辑上浮。当权限、认证、文档、日志这些通用能力被平台化，开发者就能真正聚焦于核心业务价值。

如果你厌倦了重复编写 CRUD 接口，如果你的企业正面临 API 权限混乱、文档缺失、安全漏洞等问题，那么 Surpass 值得你立即尝试。

开源地址：https://gitee.com/dromara/surpass

GitHub 镜像：https://github.com/dromara/surpass

一行 SQL，一个 API，一套权限——这就是 Surpass 给开发者的礼物。