Nebula 更新日志

2026-04-01

记录 Nebula 架构各子项目的版本迭代历史，按发布时间倒序排列。
版本号以 nebula-boot 为框架层主版本基准，nebula-support / nebula-auth / nebula-system 同步发布。

`v0.1.18` Latest

发布时间： 2026-03-26 ~ 2026-04-01

nebula-boot

feat [security] JWT Claim 新增 USERNAME / AVATAR / TENANT_NAME / LOGIN_TIME / LOGIN_IP / LOGIN_DEVICE 字段，SecurityUtils.getCurrentUser() 返回完整 IamUser
feat [mybatis] 新增 SecurityMyBatisAutoConfiguration，security 与 mybatis 同时存在时自动注册完整版 MetaObjectHandler；INSERT 时 tenantId 为 null 填入哨兵值 -1
feat [tenant] FieldIsolationStrategy 无租户上下文时注入哨兵值 tenant_id=-1，移除"无上下文跳过过滤"逻辑；NebulaTenantProperties 新增默认 ignoreTables（sys_tenant），与业务配置合并生效
feat [web] 新增全局异常处理：UnsupportedOperationException
fix [file] 优化物理文件不存在时抛出的异常提示
fix [file] 补充文件存储空实现逻辑（NoopFileStorageService）
fix 优化线程池装配注册；增加默认接口白名单，补充租户过滤表

nebula-auth 0.1.6

feat 重构认证登录服务，优化 Token 颁发流程

nebula-system 0.2.39

feat 重构认证登录服务对接
feat 编码规则新增逻辑优化
feat 新增用户模块 RPC 测试接口
feat 员工管理表名称统一替换、相关类名同步变更

`v0.1.13`

发布时间： 2026-03-24

nebula-boot

feat [core] HTTP 接口响应中自动注入 traceId 字段
feat [mq] 同步注入 TraceId 支持

nebula-system 0.2.30

feat 员工列表查询优化，userRPC 新增接口
fix 员工新增提示校验优化

`v0.1.12`

发布时间： 2026-03-24

nebula-support

feat [dependencies] 新增依赖管理：EasyExcel、MinIO、阿里云 OSS、腾讯云 COS、华为云 OBS、七牛云 Kodo、亚马逊 S3 SDK、Disruptor

nebula-boot

feat [file] 首次引入文件服务（nebula-framework-file + nebula-boot-starter-file），支持本地、MinIO、OSS、COS、OBS、Kodo、S3 多厂商存储
feat [excel] 首次引入 Excel 增强服务（nebula-framework-excel + nebula-boot-starter-excel）
feat [task] 首次引入任务中心服务（nebula-framework-task + nebula-boot-starter-task）
fix [web] 移除控制台日志打印时的响应体截断逻辑

nebula-system 0.2.23

fix 日志打印配置调整

`v0.1.11`

发布时间： 2026-03-23

nebula-boot

fix [security] 优化 JWT Token 管理逻辑：厘清服务端与客户端在认证相关配置上的职责边界
feat [web] 新增工具方法：从 Authorization 请求头提取 Bearer Token

nebula-auth 0.1.5

fix 优化 JWT Token 管理逻辑

nebula-system 0.2.23

feat 员工分页查询按工号排序
feat 字典查询公共方法优化
fix 修复若干 Bug

`v0.1.10`

发布时间： 2026-03-20

nebula-boot

fix [tenant] 移除租户默认过滤的内置表配置（避免误过滤业务表）

nebula-system 0.2.2

feat 新建员工时同步创建认证账号、绑定权限及角色
feat 用户表、字典公共方法 RPC 接口初始化
fix 限制菜单树最大层级深度为 5 级
fix 补全当前用户的租户信息（自动填充 tenantId）
feat 行政区划模块名称重构

`v0.1.9`

发布时间： 2026-03-19

nebula-boot

fix [security] 修改白名单配置：/auth/** 改为精确指定认证域接口加入白名单（登出接口需要认证不应放行）
fix [security] 优化 JWT 字段存储：新增 username 字段

nebula-auth 0.1.4

fix 更新 JWT 字段构建键值

`v0.1.8`

发布时间： 2026-03-17

nebula-boot

feat [core] 增加微服务间接口调用的统一前缀 /rpc（CommonConstants.RPC_URI_PREFIX）
fix [security] 优化接口白名单逻辑：生效白名单 = 默认白名单 + 用户配置；/rpc/** 接口默认在白名单中生效

nebula-auth 0.1.3

fix 更新系统域 RPC 接口依赖

`v0.1.7`

发布时间： 2026-03-16

nebula-boot

fix [swagger] 兼容 Knife4j v4.5 的临时方案：自定义实现 Knife4jOpenApiCustomizer

`v0.1.6`

发布时间： 2026-03-16

nebula-boot

fix [core] 修改 HTTP 成功响应状态码（0 → 200）
feat [security] 增加登录状态滑动窗口续期逻辑；新增获取当前登录用户租户 ID 的方法
feat [mybatis] BaseService.getByIdOrThrow(Long id, String message) 增加自定义错误信息参数
fix [web] 增加 Long 类型字段 JSON 序列化精度保护（防止前端 JS 丢失精度）
feat [swagger] 首次引入 Swagger 增强管理（nebula-framework-swagger + nebula-boot-starter-swagger）

nebula-system 0.1.6

feat 发号器生成逻辑迭代，完善 RPC 接口
feat 员工管理模块初始化
feat 组织架构模块初始化
feat 行政区划模块初始化
fix 菜单、角色基础接口逻辑修复
fix 角色权限查询优化

`v0.1.5`

发布时间： 2026-03-13

nebula-support

feat [dependencies] 新增 log4jdbc 包管理
fix [plugin] 修复 maven-publish 插件 afterEvaluate 执行上下文异常

nebula-boot

fix [security] 优化 TokenStore 的注册逻辑

`v0.1.4`

发布时间： 2026-03-12

nebula-support

chore [dependencies] 移除包管理：Flyway、Dubbo、Sa-Token、FastJSON2、EasyExcel、XXL-Job（精简为按需引入）
feat [plugin] 升级 Spring Cloud 至 2025.0.0，Spring Cloud Alibaba 至 2025.0.x，Redisson 至 3.52.0
fix [plugin] 优化构建插件代码规范；备注 Knife4j v4.5.0 BUG 待官方修复

nebula-boot

fix [core] 优化全局异常状态码；防止 dataOrThrow 被 Jackson 序列化为属性
feat [mybatis] 完善 BaseEntity 公共字段；完善 MyBatis-Plus 字段自动填充处理器；适配 Spring Boot 3 兼容依赖
feat [security] 补全安全模块专用错误码；优化租户管理初版
feat [tenant] 优化租户管理初版；优化租户注册配置；适配 Spring Boot 3 兼容依赖
fix [web] 优化静态资源不存在的异常处理；封装 Swagger 相关路径的响应包装豁免逻辑；将框架统一配置的 ObjectMapper 注入已有 Jackson 消息转换器
feat [flyway] 使用 tenantTag 隔离不同租户的 Flyway 脚本执行记录
fix [jdbc] 移除 Druid 强绑定关系；适配 Spring Boot 3 兼容依赖
feat [mybatis-starter] 租户感知的字段自动填充处理器
fix [tenant-starter] 优化迭代初版租户管理；优化租户注册配置
fix [nacos] 优化负载均衡策略配置
fix [mongo] 优化 MongoDB 加载配置
fix [web-starter] 优化 Web 模块依赖（Undertow、Log4j2）

nebula-auth 0.1.2

chore 版本依赖更新

nebula-system 0.1.1

feat 字典 CRUD 基础接口初始化
fix 修复 TokenStore 注册错误导致的启动报错
chore 增加 Swagger 基础配置

`v0.1.2` · 初始版本

发布时间： 2026-03-02

nebula-support

feat 项目初始化：nebula-support-dependencies（BOM 依赖管理）、nebula-boot-plugin-gradle（Gradle 构建插件）

nebula-boot

初始化以下全部框架模块与 Starter，完成技术底座基础能力搭建：

模块类型	模块清单
Framework 层	`core` / `web` / `mybatis` / `security` / `tenant` / `trace` / `flyway` / `idempotent` / `ratelimit` / `nacos`
Starter 层	`web` / `jdbc` / `mybatis` / `redis` / `mq` / `elasticsearch` / `mongo` / `openfeign` / `nacos` / `threadpool` / `log` / `tenant` / `trace` / `flyway` / `security` / `idempotent` / `ratelimit`

核心能力包含：

Web 层： 统一响应包装（R<T>）、全局异常处理、请求日志 Filter
持久层： MyBatis-Plus 集成、BaseEntity / BaseMapper / BaseServiceImpl 基类体系
多租户： TenantContext 上下文、行级隔离策略初版
认证： JWT 认证基础框架、登录 / 登出流程
链路追踪： TraceId 生成与传播基础结构

nebula-auth 0.1.0

feat 项目初始化：认证登录、登出接口、租户校验

nebula-system 0.1.0

feat 项目初始化：登录鉴权相关用户管理功能