https://macula.dev/docs/latest/11_about/Recent content in 关于Macula on MaculaHugozh-cnhttps://macula.dev/docs/latest/11_about/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97/Mon, 01 Jan 0001 00:00:00 +0000https://macula.dev/docs/latest/11_about/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97/<p>latest 文档跟随 main 分支，下列为已公开发布的版本，尚未发布的改动不计入 Release 历史。完整版本列表见<a href="https://macula.dev/releases/">变更历史</a>。</p> <div class="release-history"> <p class="release-source">版本与摘要来自 <a href="https://github.com/macula-projects/macula-boot/releases">Macula Boot Releases</a>，按发布日期排列。完整变更与升级说明见各版本的发布详情。</p> <article class="release-entry" aria-labelledby="release-5020"> <div class="release-entry-heading"> <h2 id="release-5020">5.0.20</h2> <span class="release-badge">正式发布</span> <time datetime="2026-07-07T02:24:45Z">2026-07-07</time> </div> <ul><li>将 macula-boot-starter-operationlog 纳入 parent 依赖管理</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.20" aria-label="查看 Macula Boot 5.0.20 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-600"> <div class="release-entry-heading"> <h2 id="release-600">6.0.0</h2> <span class="release-badge is-discouraged">不建议使用</span> <time datetime="2026-05-28T02:45:54Z">2026-05-28</time> </div> <ul><li>升级 Java 版本至 17，升级 Spring Boot 至 3.5.x，升级 Spring Cloud 至 2023.0.6</li><li>全面迁移 javax.* 至 jakarta.* 包（servlet、sql、validation 等），适配 Spring Boot 3</li><li>添加 macula-boot-starter-snailjob 模块，集成 SnailJob 分布式任务调度，并完善示例</li><li>修复 TraceId 获取逻辑，优化追踪链路</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v6.0.0" aria-label="查看 Macula Boot 6.0.0 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5019"> <div class="release-entry-heading"> <h2 id="release-5019">5.0.19</h2> <span class="release-badge">正式发布</span> <time datetime="2026-05-25T10:02:03Z">2026-05-25</time> </div> <ul><li>新增 OperationLog Starter，基于 @OperationLog 注解记录操作日志</li><li>新增 Lock4J 自动配置及 Redisson 不可重入锁执行器实现</li><li>Idempotent 注解支持异常时自动删除幂等 key</li><li>修复 CryptoGlobalFilter Content-Type 判断不兼容带 charset 后缀的场景</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.19" aria-label="查看 Macula Boot 5.0.19 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5018"> <div class="release-entry-heading"> <h2 id="release-5018">5.0.18</h2> <span class="release-badge">正式发布</span> <time datetime="2025-09-04T09:07:31Z">2025-09-04</time> </div> <ul><li>升级至 1.46.19-SpringCloud2021-RELEASE 版本</li><li>FIX: 使用 RawQuery 保证 AKSK 验签一致性</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.18" aria-label="查看 Macula Boot 5.0.18 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5017"> <div class="release-entry-heading"> <h2 id="release-5017">5.0.17</h2> <span class="release-badge">正式发布</span> <time datetime="2025-04-07T08:44:26Z">2025-04-07</time> </div> <ul><li>AuditLog 加入请求参数和响应结果长度限制参数</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.17" aria-label="查看 Macula Boot 5.0.17 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5016"> <div class="release-entry-heading"> <h2 id="release-5016">5.0.16</h2> <span class="release-badge">正式发布</span> <time datetime="2024-11-20T10:55:17Z">2024-11-20</time> </div> <ul><li>FIX：Cors配置的条件属性不生效</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.16" aria-label="查看 Macula Boot 5.0.16 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5015"> <div class="release-entry-heading"> <h2 id="release-5015">5.0.15</h2> <span class="release-badge">正式发布</span> <time datetime="2024-11-19T11:11:06Z">2024-11-19</time> </div> <ul><li>FIX: 灰度请求到正常的生产者也需要发送灰度消息</li><li>FIX: GrayVersionMetaHolder是在nacos注册的时候设置version的，如果bean初始化的时候需要version则要提前获取</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.15" aria-label="查看 Macula Boot 5.0.15 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5014"> <div class="release-entry-heading"> <h2 id="release-5014">5.0.14</h2> <span class="release-badge">正式发布</span> <time datetime="2024-11-12T02:52:04Z">2024-11-12</time> </div> <ul><li>实现延迟注册服务到Nacos，以便优雅升级</li><li>FIX: 修复tsf网关启动异常(引入tsf网关依赖要注意顺序)</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.14" aria-label="查看 Macula Boot 5.0.14 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5013"> <div class="release-entry-heading"> <h2 id="release-5013">5.0.13</h2> <span class="release-badge">正式发布</span> <time datetime="2024-09-09T09:40:16Z">2024-09-09</time> </div> <ul><li>升级mybatis-plus版本，添加租户是否启用选项</li><li>FIX: 防止BigDecimal的JSON序列化变成科学计数法</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.13" aria-label="查看 Macula Boot 5.0.13 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5012"> <div class="release-entry-heading"> <h2 id="release-5012">5.0.12</h2> <span class="release-badge">正式发布</span> <time datetime="2024-07-15T06:10:09Z">2024-07-15</time> </div> <ul><li>针对LocalDateTime、LocalDate、LocalTime支持全局配置格式</li><li>前端传空串给后端用Date接收的对象的时候，会报空指针异常</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.12" aria-label="查看 Macula Boot 5.0.12 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5011"> <div class="release-entry-heading"> <h2 id="release-5011">5.0.11</h2> <span class="release-badge">正式发布</span> <time datetime="2024-04-26T07:14:27Z">2024-04-26</time> </div> <ul><li>add a custom maxLimit property for PaginationInnerInterceptor</li><li>修复GET请求经过网关中文等字符编码后获取不正确的问题</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.11" aria-label="查看 Macula Boot 5.0.11 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-5010"> <div class="release-entry-heading"> <h2 id="release-5010">5.0.10</h2> <span class="release-badge">正式发布</span> <time datetime="2024-04-25T04:24:45Z">2024-04-25</time> </div> <ul><li>#15 修复经过网关后参数丢失问题</li><li>回退MyBatis Plus版本到3.5.5，解决与jpa的jsqlparser版本冲突</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.10" aria-label="查看 Macula Boot 5.0.10 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-508"> <div class="release-entry-heading"> <h2 id="release-508">5.0.8</h2> <span class="release-badge">正式发布</span> <time datetime="2024-04-24T09:40:12Z">2024-04-24</time> </div> <ul><li>WebSocket模块支持FeignClient微服务调用携带用户上下文</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.8" aria-label="查看 Macula Boot 5.0.8 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-507"> <div class="release-entry-heading"> <h2 id="release-507">5.0.7</h2> <span class="release-badge">正式发布</span> <time datetime="2024-04-24T01:09:14Z">2024-04-24</time> </div> <ul><li>升级springboot版本到2.7.18</li><li>升级mybatis-plus到3.5.6</li><li>升级seata版本到2.0.0</li><li>修复Inner注解获取NPE问题</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.7" aria-label="查看 Macula Boot 5.0.7 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-506"> <div class="release-entry-heading"> <h2 id="release-506">5.0.6</h2> <span class="release-badge">正式发布</span> <time datetime="2024-01-09T04:25:47Z">2024-01-09</time> </div> <ul><li>BizCheckException从200改为510响应，200会导致feignclient无法识别微服务层的异常</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.6" aria-label="查看 Macula Boot 5.0.6 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-505"> <div class="release-entry-heading"> <h2 id="release-505">5.0.5</h2> <span class="release-badge">正式发布</span> <time datetime="2024-01-08T11:01:49Z">2024-01-08</time> </div> <ul><li>添加BizCheckException，该异常http 200返回，用于业务检查类抛出异常，属于提醒用户输入的问题，一般无需告警</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.5" aria-label="查看 Macula Boot 5.0.5 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-504"> <div class="release-entry-heading"> <h2 id="release-504">5.0.4</h2> <span class="release-badge">正式发布</span> <time datetime="2023-12-07T03:41:04Z">2023-12-07</time> </div> <ul><li>网关支持接口加解密和签名</li><li>支持全链路灰度发布</li><li>修复RocketMQ的灰度消费问题</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.4" aria-label="查看 Macula Boot 5.0.4 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-503"> <div class="release-entry-heading"> <h2 id="release-503">5.0.3</h2> <span class="release-badge">正式发布</span> <time datetime="2023-10-20T10:58:52Z">2023-10-20</time> </div> <ul><li>支持反向角色</li><li>支持排他角色</li><li>支持人群包角色</li><li>FIX没有定义MQProcuder导致DefaultRocketMQLocalTransactionListener异常</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.3" aria-label="查看 Macula Boot 5.0.3 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-502"> <div class="release-entry-heading"> <h2 id="release-502">5.0.2</h2> <span class="release-badge">正式发布</span> <time datetime="2023-09-17T14:59:18Z">2023-09-17</time> </div> <ul><li>修复system-starter不能获取按钮权限</li><li>修复DefaultRocketMQLocalTransactionListener没有判断TxMessage</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.2" aria-label="查看 Macula Boot 5.0.2 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-501"> <div class="release-entry-heading"> <h2 id="release-501">5.0.1</h2> <span class="release-badge">正式发布</span> <time datetime="2023-09-11T12:28:52Z">2023-09-11</time> </div> <ul><li>实现RocketMQ的灰度消费支持</li><li>Result增加cause字段，表示异常原因描述</li><li>新增日志、审计、监控模块</li><li>异常包裹的result不能设置data为string，序列化有问题</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.1" aria-label="查看 Macula Boot 5.0.1 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-500"> <div class="release-entry-heading"> <h2 id="release-500">5.0.0</h2> <span class="release-badge">正式发布</span> <time datetime="2023-07-26T16:15:07Z">2023-07-27</time> </div> <ul><li>基于spring-boot 2.7.x的应用开发框架</li><li>基于spring-cloud 2021.x的微服务开发框架</li><li>macula-boot-starter-mapstruct 对象转换</li><li>macula-boot-starter-crypto 加解密模块</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.0" aria-label="查看 Macula Boot 5.0.0 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-500-rc4"> <div class="release-entry-heading"> <h2 id="release-500-rc4">5.0.0-RC4</h2> <span class="release-badge is-preview">预发布</span> <time datetime="2023-03-27T07:22:18Z">2023-03-27</time> </div> <ul><li>此版本未提供条目摘要，请查看 Release 发布详情。</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.0-RC4" aria-label="查看 Macula Boot 5.0.0-RC4 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> <article class="release-entry" aria-labelledby="release-500-rc3"> <div class="release-entry-heading"> <h2 id="release-500-rc3">5.0.0-RC3</h2> <span class="release-badge is-preview">预发布</span> <time datetime="2023-03-27T02:52:13Z">2023-03-27</time> </div> <ul><li>Feign使用的Kong支持Ipaas</li></ul> <a class="release-detail" href="https://github.com/macula-projects/macula-boot/releases/tag/v5.0.0-RC3" aria-label="查看 Macula Boot 5.0.0-RC3 的 Release 详情">查看发布详情 <span aria-hidden="true">↗</span></a> </article> </div>https://macula.dev/docs/latest/11_about/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98/Mon, 01 Jan 0001 00:00:00 +0000https://macula.dev/docs/latest/11_about/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98/https://macula.dev/docs/latest/11_about/%E8%B4%A1%E7%8C%AE%E8%A7%84%E8%8C%83/Mon, 01 Jan 0001 00:00:00 +0000https://macula.dev/docs/latest/11_about/%E8%B4%A1%E7%8C%AE%E8%A7%84%E8%8C%83/https://macula.dev/docs/latest/11_about/%E4%BD%BF%E7%94%A8%E6%A1%88%E4%BE%8B/Mon, 01 Jan 0001 00:00:00 +0000https://macula.dev/docs/latest/11_about/%E4%BD%BF%E7%94%A8%E6%A1%88%E4%BE%8B/