Dante Cloud

码匠君2024/12/19大约 3 分钟Breaking ChangeDante Cloud

v3.5.5.3

Dante Cloud v3.5.5.3 版本对 Dante Engine 核心组件库以及主工程做了大规模重构

“本次升级绝非简单的代码同步，而是一次从架构理念到实现方式的深度重构。企业版在生产环境中积累的最佳实践，对开源组件库进行了‘淬炼’：

结构上，我们重新划分了模块边界，使得 组件的内聚性大幅提升。每个组件的职责更加单一和明确，就像一个功能精湛的‘瑞士军刀’模块，开发者可以真正地像‘组装乐高’一样，按需引入所需功能，极大提升了使用的灵活性与项目的轻量化。
依赖上，我们极大地 降低了组件之间以及与第三方库的非必要耦合。这不仅减少了潜在的依赖冲突，使得与 Spring Boot 生态及其他主流依赖的集成更加平滑稳定，也让每个组件的‘独立使用’成为了可能。你现在可以轻松地将某个组件单独抽离，集成到任何基于 Spring Boot 的技术栈中。
规范上，我们确保所有组件的设计都 更严格地遵循 Spring Boot 的官方规范和习惯用法，特别是新版本 Spring Boot 新增加的用法。这意味着更低的学习成本、更熟悉的配置方式、以及更好的与 IDE 和 Spring Boot Actuator 等工具链的协同工作能力。

重要

因为代码结构出现了较大规模的变化，如果您未曾在原版基础上进行较多修改，那么建议重新检出工程代码学习和使用。如果有较多修改，建议新建一个工程重新检出代码，与现有代码对照修改
除了代码结构以外，Nacos 配置也同步进行了较大修改，建议新建一个命名空间，重新导入使用。

Bootstrap 模式（即 Bootstrap.yml）是兼容性处理模式，已经是 Spring 官方不推荐的模式。

Spring Cloud Alibaba 自 2023.0.1.3 版本起改用了新的配置方式，其实本质就是不打算继续兼容 Bootstrap 模式，因此在 Bootstrap 模式下 SCA 会出现一些问题。

因此 Dante Cloud 自 v3.5.3.0 版本起，也改用 Spring Boot 的标准配置模式，将 bootstrap.yml 统一修改为 application.yml，并去除了对模块 spring-cloud-starter-bootstrap 的依赖。

本版本为了适配 Spring Authorization Server 1.4.1，在系统中增加了两个 Token 的属性字段，以保持与 Spring Authorization Server 的一致性。

当您更新了最新的代码后启动服务，系统会自动在 oauth2_application 表中增加两个字段：bound_access_token 和 subject_dn。

subject_dn 字段不会对系统产生任何影响。但是由于系统使用的数据库组件会自动添加新的字段，不会同步设置已有信息的值，这就导致新增的另外的一个字段 bound_access_token（bool 类型）的值为 null。这就会导致系统登录时出现异常。

解决办法：

如果您已经更新了代码并且启动了服务，oauth2_application 表中会新增两个字段：bound_access_token 和 subject_dn
打开 oauth2_application 表，找到 bound_access_token 字段，将其值设置为 "false"。
清空 Redis 缓存，或者等待缓存失效后，再次尝试。

已将 Spring Cloud Alibaba 版本回滚至 2023.0.1.2

v3.3.6.0 版本将 Spring Cloud Alibaba 升级至 2023.0.1.3，这将会出现两个问题：

只能使用 spring.config.import 方式读取配置
Spring Boot 自身日志配置失效，无法在配置文件中，通过 logging.level.<logger-name>=<level> 方式灵活控制日志显示和输出