[一] 项目简介

Dante Cloud 国内首个支持阻塞式和响应式服务并行的、开箱即用的企业级云原生微服务基座。是采用领域驱动模型(DDD)设计思想，以「高质量代码、低安全漏洞」为核心，基于 Spring 生态全域开源技术，高度模块化和组件化设计，支持智能电视、IoT等物联网设备认证，满足国家三级等保要求，支持接口国密数字信封加解密等一系列安全体系的一站式多租户微服务解决方案。独创的可以“一套代码实现微服务和单体两种架构灵活切换”的企业级应用系统。

1、项目理念

Dante Cloud 一直秉承着“简洁、高效、包容、务实”的理念，使用微服务领域及周边相关的各类新兴技术或主流技术进行建设，不断地深耕细作、去粗取精、用心打造。目标是构建一款代码质量高、维护投入低、安全防护强的微服务基座，可以帮助用户快速跨越架构技术选型、技术研究探索、基础架构搭建阶段，直接聚焦业务开发。极大地降低传统项目中因安全漏洞、技术负债、低质代码等潜在隐患所产生的高维护投入。期望像项目名字寓意一样，构建一套可以在在行业变革的时期承上启下，助力企业信息化建设和数字化转型的产品。

Dante Cloud 核心关注点是：「高质量的系统代码」、「合理的系统架构」、「低耦合的模块划分」、「高安全性系统实现」、「灵活的功能扩展能力」，「优质的微服务防范」。不会像其它一些系统一样，追求 业务功能 的 丰富 性。堆叠大量无法做到真正通用的功能，反倒会成为负担和干扰，不如由用户自己按照需求灵活设计和实现。

2、架构设计

Dante Cloud 优秀的模块化能力，为系统提供了高度灵活的配置能力、功能的“可插拔”能力 以及不同需求场景的适配能力。正因为优秀的模块化体系，使得 Dante Cloud 不仅是一套完整的微服务架构，还是一套高质量的 「单体模块化」 系统。这里的微服务架构和单体架构并不是分离的两套代码，也不是分离的两个项目。而是完全融合的一整套代码，使用时可以根据需要选择是以微服务模式或者单体模式运行，配合灵活的模块能力，实现系统的多样化定制和功能的管控。

这是 Dante Cloud 微服务最大的特色之一：“一套代码、两种架构”。可以帮助企业在项目早期以单体架构快速建设项目、方便开发人员在本地进行开发以及新技术研究。在项目后期随着用户规模增大以及并发需求提升时，可以快速无缝迁移至微服务架构。

3、适用用户

微服务技术并不是 **「落伍」**了，而是进入了 「成熟期」，它的 「适用场景和边界被更清晰地定义」 了。微服务不再是一个 「必须要有」 的选项，而是一个 「权衡之后」 的选择。

Dante Cloud 也并未使用任何复杂难懂或难以上手掌握的技术，项目中所涉及核心关键组件中，其中 「近 80% 均为 Spring 生态原生组件」。技术实现均为各组件标准用法的组合与应用，编码风格和代码设计一直也在极尽努力尽量与 Spring 生态的标准规范用法保持一致，只不过经过大量的版本迭代和重构之后逐渐形成了一定的封装与抽象。

因此，我们推荐以下用户体检和使用 Dante Cloud

• 「传统项目用户」：可以先体验和使用单体版，先从“前后端分离”以及“多端适配”开始，尝试不同于传统内嵌页面的开发模式。之后也可以平滑迁移至微服务版。
• 「数字转型用户」：如果您正在考虑进行数字化转型，可以直接选择使用微服务版，不用再为“基础组件碎片化，需花大量时间整合、踩坑版本兼容”等问题而苦恼。
• 「复杂项目用户」：如果您的业务复杂度上升到一定阶段，可以直接选择使用微服务版，直接聚焦于业务开发，节省大量前期搭建基础设施、解决通用技术问题的时间。
• 「初创团队用户」：可以先使用单体版进行开发，只要代码放置规范、模块划分合理，后期可以根据需要无缝迁移至微服务架构
• 「技术尝鲜用户」：本项目并不拘泥局限于常规成熟的技术内容，目标是探索新型技术并用其来为业务的创新服务。喜欢技术尝鲜的用户可以尝鲜使用。
• 「学习提升用户」：本项目代码实现优雅和领域划分清晰，编码风格和模块实现尽最大可能与 Spring 生态规范保持一致，是深入学习 Spring 生态组件和提升技能的优秀案例

想要从传统项目转型至微服务项目的用户，建议详细阅读《企业IT架构转型之道：阿里巴巴中台战略思想与架构实战》一书（可以先读前几章）之后再上手本项目！

对于以下用户我们不建议选择 Dante Cloud

• 「单体拥趸用户」：如果您觉得单体架构可以满足您所有的架构需求，微服务繁琐庞大无法比拟单体的“方便”、“快捷”，那么建议选择其它更专业的单体项目。
• 「主流技术用户」：如果您只擅长 mysql、mybatis 等主流技术，本项目所涉及的基础技术体系可能会让您觉得格格不入，建议选择更适配您技术体系项目。
• 「功能丰富用户」：本项目定位是基础平台，自认为没有能力做到功能既丰富又通用，如果您追求拥有丰富的、开箱即用的功能后台系统，那么本项目并不适合。
• 「会话思维用户」：基于 Token 的前后端分离架构与传统基于 Session 的传统单体开发思想有较大不同，本项目无法让您完全沿用原有单体设计思路和开发思维。
• 「极简编程用户」：如果您希望通过界面拖拽就可以生成代码，或者不看文档、不用学习就可以轻松掌握相关技术，这需求与本项目的产品定位、开发理念、设计哲学背道而驰。
• 「审美品鉴用户」：本项目前端是使用组件库纯手搓构建，没有专业的美工也没有照搬主流框架，初衷是为后端开发人员接触前端提供一条更友好的途径，所以不能保证符合您的审美。

[二] 新增特性

在微服务架构的实践中，“无状态”一直被奉为金科玉律，它确保了系统的水平扩展能力和高可用性。然而，这种纯粹性在用户体验和开发效率上带来了显著的挑战：为了获取当前用户信息，每个微服务都必须自行解析令牌、查询用户中心或依赖上游传递的上下文。这不仅导致了代码的重复与冗余，更在分布式链路中埋下了信息不一致的隐患——同一个用户在不同服务中可能看到版本各异的信息，极大地增加了调试与维护的复杂度。

为此，Dante Cloud 进行了一次深思熟虑的架构演进：在严格保障服务集群本身无状态扩展能力的前提下，创新性地引入了基于 Session 的用户信息管理机制。这一改变，并非对无状态原则的背离，而是一次面向开发效率与数据可靠性的“优雅平衡”。可以使用新增的工具类 ServletSecurityUtils，通过其方法 getUserPrincipal(HttpServletRequest request) 来获取到用户信息。

响应式服务也提供了从 Session 中获取用户信息的工具类 ReactiveSecurityUtils。

这一支持为系统带来了三个维度的根本性提升：

• 开发范式简化，效率跃升：开发者无需在每一个服务中编写重复的用户信息解析代码，现在仅需一行指令即可直接从 Session 中获取完整、规范的用户上下文。这极大地简化了开发流程，降低了认知负担，让工程师能更专注于核心业务逻辑。
• 数据强一致性，根除隐患：所有微服务都访问同一个权威的 Session 数据源，从根本上杜绝了因为缓存延迟或解析差异导致的信息不一致问题。用户身份、权限、偏好等数据在整个会话周期内保持高度统一，确保了业务逻辑的准确与可靠。-
• 架构清晰度增强，维护成本降低：此举消除了服务间繁琐的用户上下文传递链条，使得代码更加简洁、内聚。系统内耗减少，稳定性和可维护性自然得到了显著增强。

本质上，Dante Cloud 是在网关认证之后，于业务服务集群内部实现了一个 “局部的、会话级的有状态”。它完美地兼顾了微服务架构的弹性优势与单体应用的开发便利性，为构建既健壮又高效的现代分布式应用提供了一个全新的最佳实践。

[三] 本次更新

• 主要更新
  • [升级] Spring Boot 版本升级至 3.5.7
  • [升级] Spring Authorization Server 版本升级至 1.5.3
  • [升级] Spring Cloud Alibaba 版本升级至 2025.0.0.0
  • [升级] Camunda 版本升级至 7.24.0，SQL 脚本同步升级
  • [升级] 服务基础 jre 和 jdk 版本升级至 17.0.17-11 和 25.0.1-11
  • [新增] 新增后端支持跨服务的从 Session 中获取用户信息
  • [新增] 改用 sm-crypto-v2 替代原有 sm-crypto 大幅提升加解密性能
• 其它更新
  • [新增] 新增物联网平台启动时动态添加平台订阅主题功能
  • [新增] 新增物联网平台默认主题权限数据初始化脚本
  • [新增] JPA 核心方法定义中，新增 Optional findOne(Specification specification) 方法
  • [新增] 新增一机一密设备签名信息生成逻辑及接口
  • [新增] 新增一型一密设备基于 Mqtt 动态注册
  • [重构] 使用 sealed 接口重构各类型实体定义基类的继承关系，提升继承关系的可控制性，减少基础定义类型无序继承问题。
  • [修复] 修复授权码模式自定义表单配置类提示使用过时方法设置问题
  • [修复] 修复系统默认 Mqtt 在出现异常以后不会自动链接问题
  • [修复] 修复策略工厂统一定义错误引起的死循环问题
  • [修复] 对 Mqtt 接受数据进行反序列化时存在泛型擦除问题，导致多层嵌套对象被转化成 Map 的问题。
  • [修复] 修复使用新版 Spring Authorization Server，授权码模式配置错误，访问 /oauth2/authorize 页面不会跳转至登录页面问题
  • [修复] 修复如果先启动 Gateway 再启动其它服务，服务发现就会失败，调用接口出现 404 的问题 fix: #ID18CG
  • [修复] 修复服务端在退出时，Mqtt v5 抛出 Mqttv5PahoMessageDrivenChannelAdapter : Error unsubscribing from [，java.util.ConcurrentModificationException: null 错误
  • [修复] 修复签名计算参数传递错误，导致签名校验失败问题
  • [优化] 优化响应式环境 @EnableHerodotusRestReactiveMessage 注解放置位置，提升代码的规范性及合理性
  • [优化] 调整授权服务器和资源服务器配置参数，将 Jwk 相关配置参数归并至更合理位置。
  • [优化] 优化前端 Nginx 配置，支持更精准的客户端 IP 获取。
  • [升级] ip 地址数据库更新至 2025.10.22
  • [升级] loki docker 镜像版本升级至 3.5.7
  • [升级] promtail docker 镜像版本升级至 3.5.7
  • [升级] tempo docker 镜像版本升级至 2.9.0
  • [升级] node red docker 镜像版本升级至 4.1.1-22
• 依赖更新
  • [升级] protobuf-maven-plugin 版本升级至 3.10.2
  • [升级] alipay-sdk-java 版本升级至 4.40.483.ALL
  • [升级] camunda 版本升级至 7.24.0
  • [升级] hutool 版本升级至 7.0.0-M2
  • [升级] loki-logback-appender 版本升级至 2.0.1
  • [升级] protobuf-bom 版本升级至 4.33.0
  • [升级] software.amazon.awssdk 版本升级至 2.35.11
  • [升级] software.amazon.awssdk.crt 版本升级至 0.39.4
  • [升级] weixin-java 版本升级至 4.7.8-20251023.110018
  • [升级] sweetalert2 webjars 版本升级至 11.26.3
  • [升级] error_prone_annotations 版本升级至 2.43.0
  • [升级] hutool 5.X 版本升级至 5.8.41
  • [升级] okio 版本升级至 3.16.2
  • [升级] opengauss-jdbc 版本升级至 6.0.2-og
  • [升级] classgraph 版本升级至 4.8.184

如果本项目对你有所帮助，欢迎 Star 一波来支持我们！

Gitee：https://gitee.com/dromara/dante-cloud

Github：https://github.com/dromara/dante-cloud

Gitcode：https://gitcode.com/dromara/dante-cloud