设备密钥认证

创建产品时，认证方式选择为设备密钥，然后在该产品下添加设备，获取物联网平台颁发的 ProductSecret、DeviceSecret 等密钥。设备接入物联网平台时，会使用物联网平台颁发的密钥信息，进行身份认证。

针对不同的使用环境，物联网平台提供以下四种设备密钥认证方案。

• 一机一密：每台设备烧录自己的设备证书（ProductKey、DeviceName和DeviceSecret）。
• 一型一密预注册：同一产品下设备烧录相同产品证书（ProductKey和ProductSecret）。开通产品的动态注册功能，设备通过动态注册获取DeviceSecret。
• 一型一密免预注册：同一产品下设备烧录相同产品证书（ProductKey和ProductSecret）。开通产品的动态注册功能，通过动态注册，设备不获取DeviceSecret，而是获取ClientID与DeviceToken的组合。

四种方案在易用性和安全性上各有优势，您可以根据设备所需的安全等级和实际的产线条件灵活选择。方案对比，如下表所示。

| 对比项 | 一机一密 | 一型一密预注册 | 一型一密免预注册 |
|

一机一密认证，是预先为每个设备烧录其唯一的设备证书（ProductKey、DeviceName和DeviceSecret）。当设备与物联网平台建立连接时，物联网平台对其携带的设备证书信息进行认证。认证通过后，设备完成激活，然后与物联网平台进行通信。

一机一密认证方式的安全性较高，推荐使用。

直连设备认证流程

直连设备支持使用 MQTT 和 HTTPS协议，认证流程如下。

[1]创建产品

创建产品时，节点类型 为 直连设备。

[2]添加设备

在已创建产品下添加设备，并获取设备证书信息。

[3]产线烧录

1. 选择直连设备接入物联网平台的协议

选择直连设备接入物联网平台的协议, MQTT 协议和 HTTPS 协议，配置设备证书信息和接入域名，进行注册认证。

注册认证的开发方法如下：

1. MQTT：MQTT-TCP连接通信和MQTT-WebSocket连接通信。
2. HTTPS：HTTPS 连接通信。

2. 根据实际业务需求，完成设备端SDK开发

例如设备物模型Topic通信、设备自定义Topic通信、OTA升级、设备影子等功能开发。

3. 在产线上，将已开发完成的设备SDK烧录至设备中

[4]设备联网认证

设备上电联网后，携带设备证书发起认证请求。

[5]设备激活上线

物联网平台校验设备证书通过后，与设备建立连接。设备便可通过设备Topic与物联网平台通信

本章节“权限管理”，主要包含前端菜单以及动态权限配置

[一]菜单管理

[1]菜单列表

在菜单管理页面，可以查看系统菜单列表，并进行相应的管理操作。

[2]新建菜单

在菜单管理页面中，新建菜单。菜单相关属性如下：

对于 Vue 类型的前端，菜单相关属性与 Vue 的路由配置相对应。以下面静态路由配置为例，进行说明：

{
  path: '/security',
  component: () => import('@/views/layouts/Index.vue'),
  meta: { title: '用户安全管理', sort: 2, icon: 'mdi-lock-pattern' },
  redirect: '/security/user',
  children: [
    {
      path: '/security/user',
      name: ComponentNameEnum.SYS_USER,
      meta: { title: '用户管理', icon: 'mdi-badge-account-horizontal', isHideAllChild: true },
      component: () => import('@/views/pages/security/user/Index.vue'),
      children: [
        {
          path: '/security/user/content',
          name: 'SysUserContent',
          meta: { title: '用户详情', icon: 'mdi-clipboard-account', isDetailContent: true },
          component: () => import('@/views/pages/security/user/Content.vue'),
        },
        {
          path: '/security/user/authorize',
          name: 'SysUserAuthorize',
          meta: { title: '用户角色', icon: 'mdi-badge-account-alert', isDetailContent: true },
          component: () => import('@/views/pages/security/user/Authorize.vue'),
        },
      ],
    },
  ]
}

属性说明：

1.应用类型

应用类型：主要用于区分当前菜单是用于哪一种终端

2.菜单场景

菜单场景：主要用于区分当前菜单是用于应用主页面菜单还是个人设置页面菜单。自 4.0.X 版本之后，开始区分菜单场景，个人设置页面采用独立菜单，支持配置。

3.Vue Router 请求路径

Vue Router 请求路径：对应前面 Vue Router 配置中的 path 的值

4.Vue Component 名称

Vue Component 名称：对应前面 Vue Router 配置中 name 的值。如果是最上级的路径，例如：上面的 /security 配置，则留空不配置任何信息

5.显示标题

显示标题：对应前面 Vue Router 配置中 meta 里的 title 的值。该值主要用于菜单以及 Tab 页上的标题显示。

6.显示ICON

显示ICON：对应前面 Vue Router 配置中 meta 里的 icon 的值。该值主要用于菜单以及 Tab 页上的 ICON 显示。当前使用 Material Design Icons，可以输入部分字符进行模糊查询。Material Design Icons(mdi)

7.Vue Component 页面相对路径

Vue Component 页面相对路径：对应前面 Vue Router 配置中 component 方法对应 import 函数中的值，实际对应前端工程中页面代码。

8.Vue Router 重定向地址

Vue Router 重定向地址：对应前面 Vue Router 配置中的 redirect 的值。没有 redirect 则留空。

9.该页面不需要KeepAlive缓存

该页面不需要KeepAlive缓存：即，Vue KeepAlive 机制。如果不设置 KeepAlive 缓存，每次打开页面都会重新绘制。如果设置 KeepAlive 缓存，就会保留页面第一次绘制状态。

10.该页面不需要权限验证

该页面不需要权限验证：页面不需要登录系统也可以访问。

11.该页面包含子页面

该页面包含子页面：对应前面 Vue Router 配置中，只要配置中包含 children，就需要选中该选项。

12.该页面包含子页面

在菜单中隐藏该节点下所有子节点：如果选中 该页面包含子页面 会显示该属性。用于控制子页面是否显示在菜单树中。

13.该页面包含子页面

该页面是三级路由页面：该选项主要用于 第三级路由页面，对应前面 Vue Router 配置中的 /security/user/content 和 /security/user/authorize 配置

[3]为菜单分配角色

新建菜单色之后，可以为该菜单指定具体的角色。

[二]元数据管理

[1]元数据列表

在元数据管理页面，可以查看系统菜单列表。元数据没有新增和删除操作，主要原因手动管理会非常笨拙系统提供了自动管理机制，只需要在该功能上进行修改操作即可。

[2]元数据分配权限

这是系统的核心管理操作，也是控制 REST API 权限的核心管理功能。

详细的权限设计，参见【权限体系设计】。

[3]动态修改接口权限

Dante Cloud 最大的特色之一，就是不需要在接口上手动写死 @PreAuthorize 注解，通过后台管理功能就可以动态变更接口的权限。

选择一条元数据信息，点击修改即可以动态修改 REST API 或 gRPC 的权限。

具体的权限类型说明：

• permitAll：允许所有请求通过，无论用户是否认证、是否匿名、有无特定角色。不做任何安全检查
• anonymous：仅允许 匿名用户 （即未登录的用户）访问。如果当前用户已通过身份认证（包括 remember-me 认证），则拒绝访问（返回 403）。
• rememberMe：仅允许通过 Remember-Me 记住我功能 认证的用户访问。如果用户是通过普通登录（用户名/密码）认证的，或者未认证，则拒绝访问。
• denyAll：拒绝所有请求，无论用户身份如何。即强制返回 403 禁止访问。
• authenticated：要求用户已经通过身份认证（即已登录），包括通过普通登录和 remember-me 登录的用户。匿名用户将被拒绝。
• fullyAuthenticated：要求用户是 完全认证 的，即不是通过 remember-me 认证的。用户必须通过正常的登录流程（如提供用户名/密码）完成认证。如果当前用户仅通过 remember-me 认证，则会被拒绝。

Dante Cloud 的主要权限体系采用的 RBAC 权限模型，在此基础之上进行了一定的扩展。相关的数据模型设计如下：

详细的权限设计，参见【权限体系设计】。权限体系主要涉及的管理功能如下：

[一]用户管理

[1]用户列表

在用户管理页面，可以查看系统用户列表，并进行相应的管理操作。

[2]为用户分配角色

新建完用户之后，可以为该用户指定具体的角色。

[二]角色管理

[1]角色列表

在角色管理页面，可以查看系统角色列表，并进行相应的管理操作。

[2]为用户分配权限

新建完角色之后，可以为该用户指定具体的角色。

[三]权限管理

在权限管理页面，可以查看系统权限列表，并进行相应的管理操作。

[四]默认角色

Dante Cloud 支持手机验证码登录、第三方应用社会化登录。

这几种登录方式，均支持用户的自动注册。自动注册后的用户，仅能实现登录，是没有任何权限的。

默认角色功能，就是为涉及自动注册类型的登录，提供默认的角色，以保证用户使用该种方式登录后拥有默认的权限，可以正常使用系统。

总结

RBAC 相关管理功能，总体就是在管理 RBAC 相关的基础数据，以及数据之间的关联关系，这和大多数系统的管理功能相同。

Dante Cloud 核心认证授权功能是基于支持 OAuth 2.1 协议的 Spring Authorization Server 组件实现。

在 OAuth2 协议中，客户端 是最关键和最核心的概念之一，Dante Cloud 中的 应用管理 就是对 OAuth2 客户端 的管理。

[一]应用管理

[1]应用列表

在应用管理页面，可以查看系统应用列表，并进行相应的管理操作。

[2]关键参数

管理 应用 会涉及到很多参数，这些参数都是 Spring Authorization Server 所需要的参数。

因为参数比较多，这里仅对常用的、必要的参数进行解释说明。对于非必要的、不影响使用的参数将会掠过。感兴趣的朋友可以深入看看 Spring Authorization Server 的源代码。

1.应用名称

起一个名字，用于区分不同的应用

2.应用类型

用于区分当前的 应用 （或者 OAuth2 客户端）的主要用途。

3.认证模式

即当前的 OAuth2 客户端 支持哪些认证模式。目前 Dante Cloud 支持以下认证模式。

• 授权码模式（Authorization Code Grant）
• 客户端凭证模式（Client Credentials Grant）—— Dante Cloud 扩展认证模式，支持 REST 接口通过 Scope 进行鉴权
• 设备码模式（Device Authorization Grant）
• 密码模式（Resource Owner Password Credentials Grant）—— Dante Cloud 自定义认证模式
• 社会化模式（Social Credentials Grant）—— Dante Cloud 自定义认证模式
• 通行密钥模式（WebAuthn Credentials Grant）—— Dante Cloud 自定义认证模式
• Authorization Code + PKCE
• OpenID Connect

详细的使用方法，参见：【登录认证模式】

4.客户端验证模式

OAuth2 的很多认证模式，在进入认证逻辑之前，要先对 客户端 的 合法性 进行验证，以增强安全性。主要是针对客户端 clientId 和 clientSecret 的验证。

验证 clientId 和 clientSecret 的方法（即：Spring Authorization Server 中的 ClientAuthenticationMethod 属性）也有很多种，主要有：

• client_secret_basic
• client_secret_post
• client_secret_jwt
• private_key_jwt
• tls_client_auth
• self_signed_tls_client_auth
• none

因为，其中部分验证方式要么很少使用，要么当前 Dante Cloud 尚不支持。目前主要使用的验证方法是：client_secret_basic、client_secret_post 和 none 三种：

• client_secret_basic 的含义，即：以 Basic Header 的方式传递 clientId 和 clientSecret。

使用时，以<clientId>:<clientSecret>的格式对客户端凭据进行 Base64 编码，将编码后的值放入到请求的 Authorization Header 中。

'Authorization ': 'Basic ' + Base64.encode(<clientId>:<clientSecret>)

• client_secret_post

client_secret_post 与 client_secret_basic 作用类似，不同点是：

• client_secret_post ：将 clientId 和 clientSecret 值直接放入在 POST 的请求体中
• client_secret_basic：将 clientId 和 clientSecret 值放入在 POST 请求的 Authorization Header 中。

因为作用相似，所以在配置 Spring Authorization Server Client 信息时，通常 client_secret_post 和 client_secret_basic 都是成对出现。

• none

只有当前的 OAuth2 客户端为 Public Client 时，Client Authentication Methods 参数才能设置为 none。

这意味着该客户端是面向公共开放的或者是用户自己可以保障绝对信任的

5.回调地址

回调地址，即授权码模式中的 redirect_url。

6.是否需要认证确认

在标准的授权码认证模式中，会涉及两个 Web 页面：一个为登录页面，用于用户输入登录认证信息进行登录；另一个为确认页面，用于用户指定具体授权的 Scope。

标准数场景下，这两个页面都需要。但是，在有些场景下，可能就不需要确认页面。

所以，是否需要认证确认 参数的作用，就是用来控制是否需要在授权码认证流程中，显示确认页面。

7.客户端密钥过期时间

一个安全保障性参数，用于设定 clientSecret 的有效期。一旦超过密钥有效期，该 客户端 将无法继续使用。只有修改了 客户端 密钥过期时间之后，才能继续使用。

8.令牌有效期

令牌有效期，是指 Access Token 的有效期，这也是一个重要的参数。令牌有效期到期之后，该令牌将无法再继续使用。对应到前端界面来说，令牌到期之后，用户就只能重新登录系统。

9.刷新令牌有效期

刷新令牌有效期，是指 Refresh Token 的有效期，这也是一个重要的参数。刷新令牌有效期到期之后，客户端 将无法使用刷新令牌来获取 Access Token。之只能重新获取新的 Access Token 和 Refresh Token

10.授权码有效期

授权码有效期，是指授权码认证模式中，返回的 code 的有效期。这是 OAuth2 协议中，保障安全性的一个重要措施。

11.设备激活码有效期

设备激活码有效期，是指设备码模式中，激活码的有效期。这是 OAuth2 协议中，保障安全性的一个重要措施。

12.是否允许重用刷新令牌

刷新令牌 Refresh Token 一旦到期之后，将无法继续使用，只能重新申请新的 Access Token （新的 Access Token 中会包含新的 Refresh Token）。

但是，有些场景下 Refresh Token 到期后，可能还是需要能够继续使用原有 Refresh Token。那么，就可以通过设置 是否允许重用刷新令牌，实现 Refresh Token 的复用。

[二]范围管理

范围管理，是指对 Scope 的管理。Scope 是 OAuth2 协议中最核心的 权限 元素。OAuth2 协议中，就是利用 Scope 来实现鉴权。

[1]范围列表

在范围管理页面，可以查看系统范围列表，并进行相应的管理操作。

[2]为范围配置权限

新建完范围之后，可以为该范围指定具体的权限。

在前端界面中，Dante Cloud 提供了部分安全相关的管理和展示功能。

[一]凭证管理

凭证管理，即 Token 管理。可以查看目前系统已经颁发的 Token 详情。删除某个 Token 将会强制 用户 或者调用接口的 客户端 重新登录系统。

[二]日志审计

日志审计，主要用于显示用户登录、登出等操作的详细日志信息。该功能是等保测评以及企业应用安全合规性测试中，必须要具备的功能。

[三]接口审计(企业版)

接口审计，主要用于记录用户在系统中的各项操作（实际调用了哪些 REST API）。接口审计功能是等保测评以及企业应用安全合规性测试中，必须要具备的功能。

在很多应用场景下，都会涉及到自签名证书的使用。例如：在 Spring Authorization Server 中使用证书来计算 JWT Token 的签名，使用 SSL 来提升 Http Client 访问的安全性等。特别是在微服务架构系统中，为了提升安全性，需要使用到 SSL 或者证书的地方更多。

通常，我们要生成自签名证书，都是使用例如 JDK 自带 Keytool 工具或者安装 OpenSSL，通过在命令行输入指令来生成证书。

虽然 Keytool 或 OpenSSL 使用都很方便，但这都是独立于应用以外的工具，通过程序代码调用特别时 Java 代码，并不是很方便。而且，在使用时还需要了解一大堆的参数，对于不经常使用 Keytool 或 OpenSSL 的用户来说，想要把各种参数了解清楚并无误的生成证书，也是需要花费一定的时间经历的。一段时间不用，可能就忘记了，需要使用的时候还需要再了解一次。最主要的是，外部命令行工具，没有一个统一的、可视化的管理机制。

为了解决这个问题，Dante Cloud 单独开发一套证书管理功能模块，不依赖 Keytool 或 OpenSSL，通过系统界面输入必要参数，就可以签发根证书、CA 证书以及最终实体证书。证书信息通过系统统一管理，支持本地和远端文件存储，还支持不同格式的导出。

[一]证书管理

[1]证书列表

在证书管理页面，可以查看系统证书列表，并进行相应的管理操作。

[2]新建证书

新建证书，根据界面提示输入相关信息，新建证书

说明：

1. 根证书：它是证书颁发机构（CA）的最顶层证书，是整个信任链的起点和锚点。通常存储在离线的硬件设备中（就像锁在保险柜里），不直接参与日常的网络通信，以防被窃取。
2. 中间根证书：连接根证书和最终用户证书的桥梁。它活跃在服务器上，负责实际的证书签发工作。如果中间证书被黑客入侵，CA可以吊销它，而无需动到最顶层的根证书，从而保护了根证书的绝对安全。
3. 最终实体证书：也就是叶子证书，是最终用户实际使用的证书。它上面绑定了具体的网站地址（如 google.com）或用户身份。通常有效期较短（如90天或1年），需要定期续期。

[二]证书下载

通过证书管理功能新建了证书之后，Dante Cloud 并不会马上生成对应的证书文件。如果需要使用具体的证书文件，点击下载按钮选择具体的之后，Dante Cloud 才会生成对应格式的证书文件，同时将其下载给用户。

证书文件生成之后，可以通过查看文件列表来查看具体的文件。

[三]后续计划

当前，开源版和企业版均使用该功能生成的证书，为 Spring Authorization Server 提供 JWT Token 签名支持。

后续，可能会根据开发安全以及实际需要，开发证书体系相关的证书吊销、OCSP 以及 ACME 等完整的 PKI 管理功能。

用户登录系统之后，默认进入的页面就是 个人主控台，也就是常见的 Dashboard。

当前 Dante Cloud 个人主控台中的图表，除了 实时在线用户 外基本为假数据，仅用于效果的展示。之所以这样做的原因如下：

1. 一方面，目前没有找到比较合适的、与平台相关的、适用于主控台展示的、偏重系统管理的数据统计内容。考虑到如果盲目的增加一些，看似为真实的内容实则使用价值不高数据统计，反倒会增加使用和改造的成本。
2. 另一方面，真实可用于生产的数据统计内容，通常会涉及定时任务、数据提取计算以及数据视图或存储过程的辅助，并结合实际业务，才能保证数据图标展示的价值性。如果现在增加这部分内容，会影响用户搭建和使用的复杂度。
3. 再一方面，Dante Cloud 还在持续不断的升级和完善中，如果在新增某个功能时发现有特别价值性的统计分析功能，也会同步增加上来。

[一]实时在线用户

微服务（或者前后端分离系统）由于是基于 Token 的运行设计逻辑，与传统基于 Session 的单体有较大区别。

传统基于 Session 的单体，可以基于 Session 来统计实时在线用户情况（虽然也不是特别的精准）。但是基于 Token ，由于其本身就是无状态的，价值是存储在客户端中（即使后端会存有 Token 的数据），也很难实时统计在线的用户情况。

因为 Dante Cloud 提供了完善的 WebSocket 服务（支持跨实例的消息发送），所以结合这一点来实现 实时在线用户 的统计。基于 WebSocket 来实现 实时在线用户 的统计，有以下优点：

1. 实时在线用户统计比较精确。利用 WebSocket 自身的特性（包括：Session 以及通信逻辑），可以很好的规避 Token 无状态性，让用户是否在线的状态性更加精确。
2. 应用场景更贴合实时用户统计。WebSocket 通信通常是需要与前端界面进行配合的，这也就决定了这种场景下统计实时在线用户更有意义。假设还有很多用户是采用调用 API 接口的方式来使用系统，那么这对这一类用户统计实时在线性的就没有意义。

因为只要生成了 Token，什么时间调用完全由用户控制，而且调用响应时间通常不会很长，这种情况下不存在所谓的 在线

在常规的系统开发中，是离不开 字典 的使用的。常规的系统设计会将字典类型的数据设计成 字典表，在通过关联查询给用户提供更直观、更易理解的信息展示。除此以外，特别是在 Java 编程语言中，会使用定义枚举类型来定义 字典。

这两种方式都各有利弊：

1. 使用 字典表：就需要与实际业务的 SQL 进行强关联，不容易做成通用性。而且，频繁的查询会增加数据的压力，而且不便于实际代码使用。
2. 使用枚举：使用枚举类型字典，可以很好的与代码融合，甚至作为参数进行前后端传输。但这种方式不好与 SQL 进行融合。

如果深入思考一下，其实 字典 终极用途就是为了 更人性化的显示信息同时支持动态的管理。不管是使用 SQL 关联查询的方式还是 Java 枚举的方式，都是为了给用户更直观的信息展示，而不是单纯展示关联的 id 或者 code。

因此，Dante Cloud 选择了 Java 枚举的方式来做 字典，同时提供了聚合管理方式来支持字典管理。这样做的好处有以下几点：

1. Java 枚举可以很好的和 Java 代码融合，不管是作为分类还是类型判断都很方便。
2. 使用枚举聚合的机制，实现了 Java 枚举的完全动态管理，无需手动录入数据。详见：【枚举字典聚合】
3. 利用 JPA 实体支持枚举属性以及支持使用枚举作为查询参数的特性，将 Java 枚举与实际 SQL 查询进行关联，而无需单独设计 字典表 进行关联查询。
4. 提供统一的接口，前端使用字典时 随用随取，并采用前端缓存避免反复查询后端。既提高的数据使用效率又避免大量查询或者缓存数据影响性能。

[一]字典管理

在系统前端提供了 字典 统一管理界面。

人事管理，即企业内部信息系统中的单位管理、部门管理以及人员管理等常见功能。之所以将人事管理相关功能，作为 Dante Cloud 基础功能之一，主要有以下考虑：

1. Dante Cloud 除了定位于面向互联网以外还希望可以服务于企业内部使用。
2. 除了小程序、第三方系统社交用户等用户类型之外，企业人员类型用户也是一种典型用户类型，Dante Cloud 期望通过对这种类型用户的兼容，以提升整个系统用户体系的兼容能力
3. Dante Cloud 提供了工作流体系的支持，人事管理体系是与工作流用户体系非常契合的一种用户体系。
4. 人事管理也是微服务的一个典型应用场景，通过平台统一的用户管理，可以实现对外提供用户信息接口的调用，便于多系统的整合及调用。

同时，结合作者以往的工作经验，Dante Cloud 对传统的人事管理功能进行一定个性化设计，主要的特点就是增加了 人员归属 功能。

在企业信息管理系统中，除了单位、部门以及人员这类常规的组织机构形式外，还会存在团青、社会组织等其它多种类型的组织机构形式。在传统单体系统建设时期，就会出现以下问题：

1. 大型企业会根据面向团青、社会组织等不同的业务领域，分别建设不同的应用系统。早期各个系统管理各自的组织机构，并不会出现什么问题。随着信息化的发展，需要统一和整合多个系统时，不同的组织机构和用户体系就很难进行统一。
2. 一些企业会直接在现有的系统中，增加团青、社会组织等组织体系的支持。由于与常规组织机构和用户体系的不兼容，常见的解决措施就是会在同一套系统中建设两套用户信息。例如：在人事组织机构体系下的人员 A，对应的系统用户为 a。现在为了适应新的团青组织机构，不得不新建一个用户 b。这样就出现，一个人员在同一个系统对应两个用户的局面。

人员归属 功能就是为了解决以上问题。主要的设计思想是，系统中始终维护一套人员信息以保证人员信息的唯一性和易维护性。单位和部门支持不同类型的组织机构形式，通过 人员归属 功能维护人员与不同类型组织机构的关联关系。这样，不同组织机构类型互不影响并且互相独立，也可保证系统中始终维护一套标准的人员信息。

[一]单位管理

[1]单位列表

在单位管理页面，可以查看系统单位列表，并进行相应的管理操作。

[二]部门管理

[1]部门列表

在部门管理页面，可以查看系统部门列表。

[2]管理操作

需要先选中左侧的某个单位之后，才能进行响应的操作。

[三]人员管理

[1]人员列表

在人员管理页面，可以查看系统人员列表，并进行相应的管理操作。这里不需要与任何单位和部门进行关联。

[四]人员归属

[1]归属列表

在人员归属管理页面，可以查看某个单位的具体部门下，已配置的人员列表。

[2]归属配置

选中某个单位的具体部门后，可以从系统人员列表选择具体的人员，与组织机构进行关联。

自 v4.0.X 版本开始，Dante Cloud 开源版全面改用 AWS S3 V2 组件作为 OSS 访问操作的基础组件。原 Dante OSS 组件库已不再进行维护。

改用 AWS S3 V2 组件可以更好的基于 S3 协议操作 OSS，避免了像原 Dante OSS 为了适配不同厂商 OSS 产品，所带来的大量适配工作（不同厂商在 S3 基础之上做了大量的扩展工作）。但这也导致无法全面支持除了 AWS 以外的任何一家厂商的 OSS 功能。

加之轻量级开源 OSS Minio 已经不再开源。为了方便用户使用，Dante Cloud 基于 AWS S3 V2 组件提供的 API，参考 Minio 界面在前端工程中实现了一套管理界面，以方便用户使用

[一]存储桶管理

[1]存储桶列表

在存储桶管理页面，可以查看 OSS 存储桶列表，并进行相应的管理操作，包括：开启和关闭存储桶 Public 状态

[2]新建存储桶

在存储桶管理页面，可以新建存储桶。

[二]对象管理

[1]对象列表

在对象管理页面，可以查看 OSS 对象列表，并进行相应的管理操作。对象列表支持 OSS ContinuationToken 方式的分页。

[2]对象设置

点击对象列表中某个对象的 设置 按钮，可以进行相应的设置操作

设置对象留存策略

设置对象保留策略

查看对象版本信息

Dante Cloud 提供用户名密码、手机短信验证码、第三方系统社会化、Passkey 通行密钥等多种登录方式。同时，也支持为小程序等应用提供登录认证支持（为后端接口支持前端暂不支持体验）

[一]用户名密码登录

Dante Cloud 支持用户名密码登录方式。是通过自定义扩展 Spring Authorization Server，实现基于 OAuth2 的 密码 认证模式，来实现的用户名密码登录。

[二]手机验证码登录

Dante Cloud 支持手机验证码方式。

[三]第三方系统社会化登录

第三方系统社会化登录，即利用用户在第三方系统中的账号，来登录 Dante Cloud 系统。这中登录方式，在互联网应用中颇为常见，例如：可以使用支付宝账号登录淘宝或者其它系统。

在 Dante Cloud 中的示例配置方式如下：

herodotus:
  assistant:
    access:
      justauth:
        enabled: true
        configs:
          GITEE:
            client-id: 7c1623d76f3909757912338688cae8a061e241b56070face6d54114eb61
            client-secret: 8c343cad9ca732d54242f002d254239e17b68cab11c1d506a57822be
            redirect-uri: http://aw255fkfqy5m.ngrok.xiaomiqiu123.top/social/oauth2/callback/GITEE
          OSCHINA:
            client-id: 7c1623d76f3909757912338688cae8a061e241b56070face6d54114eb61
            client-secret: 8c343cad9ca732d54242f002d254239e17b68cab11c1d506a57822be
            redirect-uri: http://192.168.101.10:8847/herodotus-cloud-uaa/oauth/social/gitee

Dante Cloud 会根据 yaml 中已经配置的第三方系统信息，在前端动态显示可用的第三登录信息，如下图所示。

[四]内置授权码模式登录

为了向用户展示更多的 OAuth2 登录方式，在 Dante Cloud 前端界面中，除了常规的 密码 模式外，还增加了 授权 模式。授权码模式是 OAuth 2.1 协议中，主推的登录模式。如下图所示：

[五]通行密钥登录(Passkey)(企业版)

通行密钥 Passkey 是一种新型的 无密码登录 技术，旨在提高在线账户的安全性并简化登录流程。它利用非对称加密技术，通过公钥和私钥对用户身份进行验证，避免了传统密码的使用。

通行密钥 Passkey 登录方式与其它登录方式不同，使用通行密钥 Passkey之前，首先要成功登录系统，然后在系统中注册通行密钥 Passkey之后才能使用。

在 Dante Cloud 中，首先要登录系统，然后在个人账号页面中【注册通行密钥】，如下图所示：

注册比较简单，只需要输入一个标签名称即可，用于区分具体的注册源。

输入完同行密钥的标签后，就会调用当前系统（设备）支持的登录方式。作者使用的是 Windows 系统，同时配置了 Pin 登录方式，所以就会弹出 Pin 输入框，用于验证是否有本地设备登录权限。

验证通过后，系统就会记录当前设备的登录信息，之后就可以使用通行密钥 Passkey 登录 Dante Cloud。

使用效果

说明

开发指南旨在帮助 Dante Cloud 用户，更深入的掌握各个系统模块的开发与扩展，设计的思想及技术实现的细节。希望通过对本指南的学习和了解，尽可能全面的掌握 Dante Cloud 的代码的编写方法。

交流

1. Dante Cloud 涉及的内容较多，而且相关内容均力争使用最新、最好的技术，所以对技术基础的要求较高。
2. 既然选择了 Dante Cloud、选择了微服务，那么就请抱着更开放的心态来拥抱新的技术知识体系，切忌不要什么问题都拿旧有的知识生搬硬套。
3. 如果在学习的过程中，对介绍的内容有疑惑或者疑问，可以提ISSUE。真心交流的可以进入交流群深入讨论。官方交流群：【点击了解入群方式】

[1]功能特性

1.基础依赖全面升级

1. Dante Cloud 4.X 使用 JDK 版本已经全面升级至 25，充分发挥虚拟线程的能力
2. Spring Boot 版本升级至 4.0.3
3. Spring Cloud 版本升级至 2025.1.1
4. Spring Cloud Alibaba 版本升级至 2025.1.0.0
5. 全面迁移至 Jackson 3，提升序列化/反序列化性能与安全性

2.全新模块架构

1. 基于 Spring Boot 4 “New Moduler Design” 体系，重构整个核心组件库模块，适配新体系下的模块划分和使用，进一步强化模块的内聚性和独立使用能力
2. 工程 maven dependencies 体系，由原来“继承”模式变更为 import 模式，增强工程的独立性以及模块引入的便捷性，避免在多工程场景下各个工程只能串行使用效率低下问题

3.API 版本控制

1. 新增 REST API 版本控制能力，支持请求头、请求路径和请求参数三种 API 版本设置模式，可通过配置修改。默认已开启基于请求头的版本控制。
2. 新增支持带 API 版本的 REST 接口动态接口鉴权能力，接口权限实时在线变更，不同版本接口可独立设置不同权限

4.改进 gRPC 通信

1. 使用 Spring gRPC 组件替换原有 net.devh grpc-srping-boot-starter，并扩展 gRPC 的动态服务发现能力，让 gRPC 与系统的融合更加成体系化
2. 新增基于 Spring Security 的 gRPC 方法动态鉴权能力，与 REST 接口权限体系保持一致，让 gRPC 通信更加安全

5.安全防护增强

1. 全新实现 PKI 证书管理模块，支持在线生成与管理，无需使用传统命令行方式生成和管理证书
2. 系统基于 Spring Authorization Server 的授权服务器加密逻辑，全部修改为使用系统 PKI 模块生成证书
3. 改造 Spring Boot Admin 监控服务，增加登陆认证保护。使用 Dante Cloud 系统自身提供的 OAuth2 / OIDC 作为 Spring Boot Admin 主要的登录模式
4. 新增静态接口权限 Customizer 聚合模式，服务可根据实际依赖模块按需、动态装配静态接口权限，减少静态权限的重复设置和不必要的解析，进一步提升接口鉴权效率
5. 服务 Docker 镜像基础 JDK 修改为 liberica 加固镜像，以提升镜像整体安全性及性能

6.OSS对象存储

1. 原 Dante OSS 工程已经停止维护，使用 AWS S3 V2 权限实现 OSS 管理模块，并合并至核心组件库
2. 支持在线生成与管理，基于 AWS S3 V2 API 能够提供的能力，全新实现前端对象存储管理功能
3. 重构本地文件存储和远程文件存储多层文件管理逻辑，让代码逻辑更清晰、运行更稳定、配置修改，也更容易理解和维护。

7.前端功能改进

1. 基于 Vuetify Material Design 3 蓝图风格以及 Vue 3 组合式 API，全新编写新版管理界面
2. 采用 monorepo 模块化设计，原版前端(Quasar版)和前端新版(Vuetify版)，共享通用化代码模块，提升代码维护的便捷性
3. 前端菜单权限大幅调整，支持根据多角色动态获取菜单。
4. 支持多类型动态菜单，个人页面菜单从静态化菜单变更为支持动态化配置管理
5. 大幅提升前端代码 Tree shaking 能力和性能
6. 前端组件库模块新增组件 Resolver 支持，方便 IDE 更好的识别组件及其定义

8.其它改进提升

1. Dante Cloud 主工程也支持中央仓库和 Maven 私库发布，服务的开发和代码组织可以更灵活
2. 使用更优雅及更合理的方式重构自定义 JPA 二级缓存实现，彻底解决需要修改 Hibernate 源代码的问题
3. 优化平台和服务配置，按照 Servlet 和 Reactive 不同环境需求进行拆分，以增强不同运行环境配置的独立性
4. 重构本地文件存储及服务间文件传输体系，简化代码逻辑，清晰化代码定位，便于理解和维护
5. 重构基础 Service 和 Controller 定义，在原有 Spring Data 实体绑定基础上，支持 DTO 类型请求和响应实体。同时支持 Spring Data Page 和 Slice 两种分页场景

[2]注意事项

1. 因为全新架构了核心组件库中的模块，核心模块坐标已统一变更为 org.dromara.dante（企业版保持不变），建议全新检出代码，避免因模块结构调整导致冲突
2. 数据库和 Nacos 配置等，也存在较多的变化，与之前版本无法兼容，要使用新版本建议重新建库和导入配置文件。
3. 若通过 ZIP 方式导出代码，需注释 git-commit-id-maven-plugin，否则编译会因缺少 .git 文件夹报错。建议通过 Git 克隆代码以保留版本记录功能

[二]Dante Cloud 3.3.X 版本

[1]新特性

• Spring Boot 已升级至 3.3.0
• Spring Authorization Server 已升级至 1.3.0
• 全面采用 Java 21，默认开启虚拟线程，以改善阻塞操作的处理降低系统资源的消耗
• 支持传统的 阻塞式 微服务与基于 Reactor 和 WebFlux 的 响应式 微服务同时运行在一套系统之中
• 不强制使用 响应式 方式开发，可根据自身项目对资源吞吐量、资源消耗、特殊功能性能保障的需求，灵活的选择是采用 响应式 还是 阻塞式 来开发对应的服务。
• 在保持 Dante Cloud 原有 Spring Authorization Server 深度扩展的各种特性的前提下，实现 响应式 服务的动态鉴权与现有体系的完全融合（无需在代码中使用 @PreAuthorize 写死权限，全部通过后台动态管理）
• 向“响应式编程”转变，基于 Reactor 重构大量核心代码，进一步提升本系统代码质量和运行效能
• 重新架构所有核心组件模块，进一步降低各模块的耦合性，减少第三方组件依赖深度，简化各模块使用的复杂度，使用更贴近 Spring Boot 生态官方写法，提升模块组件的可插拔性以及 响应式 和 阻塞式 不同环境下自动配置的适配能力
• 实现 响应式 和 阻塞式 不同类型服务，Session 共享体系以及自定义 Session 体系的完美融合（谁说微服务就一定用不到 Session ：））。
• 新增 GRPC 服务间调用和通信方式，系统核心服务间调用支持 OpenFeign 和 GRPC 两种方式，可通过修改配置实现两种方式的切换。
• 基于 RSocket 全面重写 WebSocket 消息系统，实现 WebSocket 的 响应式 改造以及 RSocket 与 Spring Security 体系的全面集成。支持多实例、跨服务的私信和广播
• 新增 OAuth2 独立客户端，可用于客户端动态注册以及授权码模式
• 新增基于 Loki + Grafana 生态的轻量级日志中心和链路追踪解决方案，使用 OSS 作为数据存储，极大地降低资源需求，可作为原有 Skywalking 和 ELK 重量级体系的备选方案，根据实际需要切换。
• 开放纯手写动态表单功能。可实现BPMN、动态表单、Camunda 流程引擎的串联，实现工作流程运转（目前仅支持简单工作流）
• 开放包含自定义属性面板的 BPMN 在线设计器功能。
• 开放物联网设备认证和管理模块，支持基于 Emqx 的物联网设备通信和管理。
• 开放阿里云内容审核、百度 OCR、环信、Emqx、天眼查、Nacos、PolarisMash等第三方 OpenApi 封装模块
• 前端工程支持 Docker 运行，相关参数可通过配置环境变量修改。已上传至 Docker Hub，可以直接下载运行。

[2]设计答疑

1. 为什么不做“纯血”响应式

响应式固然有其优势所在，但是使用响应式也不得面对一些现实问题：

• 要做纯血响应式，首先要有生态的保证。目前响应式的接受度还并不是很高，很多组件还都不支持响应式。除非有精力将所有用到的不支持的组件改写一遍，否则很难做到纯血，特别是对于微服务系统来说。
• 绝大多数应用都是需要使用数据库的，Java 领域现有的 orm 组件，要么不支持响应式（比如 JPA）、要么支持的不是特别好（比如 Hibernate）、要么需要自己编写的内容太多（比如 R2DBC），所以从投入产出比的角度说目前在数据层面做响应式并不“划算”

所以，还是要具体看应用系统的类型，在条件不具备的情况下没有必要做到纯血响应式。

2. 响应式可以带来哪些好处

响应式对阻塞式的好处，网上有大把的文章介绍，具体就不赘述了。对于实际应用中比较明显的优势：

• 响应式资源的利用效能更高，对于高资源消耗的功能，响应式的优势更突出
• 微服务系统往往会需要集成更多内容，特别在数据层面，可能会存在同时使用多种类型数据存储以及数据的流转和迁移，常规事件驱动与响应式的“流”式思维比传统阻塞式更为契合。
• 响应式可以与事件驱动更好的配合。在 Spring 生态中在多个方面都大量使用了事件驱动，而响应式的核心设计思想也与事件驱动殊途同归。

正因为 Dante Cloud 用了很多 Spring Integration 的内容，传统阻塞式方式越用越别扭，才越来越觉得有必要做响应式支持。如果有时间可以好好看看 Spring Integration，也许会为你打开一个新的世界。

3. 学习响应式编程有哪些难点

• 如果基于 Reactor 学习响应式编程，难点和突破点就在于 Flux 和 Mono 两个类。把这两个类的方法用透、弄明白，基本上就可以消除所有开发阻碍了。
• 响应式编程最大的难点就是编程思维的转换，因为习惯了阻塞式编程，一时会很难适应响应式的流式开发思维

世上无难事只怕有心人

[三]Dante Cloud 3.0.X 特性

[1]核心基础依赖便捷切换

• 新增 Spring Cloud Tencent 和 Spring Cloud 原生微服务全家桶等两种基础设施支持。
• 新增 Spring Cloud Alibaba、Spring Cloud Tencent 和 Spring Cloud 原生微服务全家桶三种基础设值切换能力，可以以相对便捷的方式切换使用 Alibaba、Tencent、Spring 等基础设施环境。可根据自身实际需求选择，不再局限于只能在某一种基础设施环境中运行。

[2]Spring Authorization Server 全特性支持及扩展

• 基于 Spring Authorization Server 和 Spring Data JPA 实现多租户系统架构， 支持 Database 和 Schema 两种模式。
• 基于 Spring Data JPA，重新构建 Spring Authorization Server 基础数据存储代码，替代原有 JDBC 数据访问方式，破除 Spring Authorization Server 原有数据存储局限，扩展为更符合实际应用的方式和设计。
• 基于 Spring Authorization Server，在 OAuth 2.1 规范基础之上，增加自定义 Resource Ownership Password (密码) 认证模式，以兼容现有基于 OAuth 2 规范的、前后端分离的应用，支持 Refresh Token 的使用。
• 基于 Spring Authorization Server，在 OAuth 2.1 规范基础之上，增加自定义 Social Credentials (社会化登录) 认证模式，支持手机短信验证码、微信小程序、基于 JustAuth 的第三方应用登录， 支持 Refresh Token 的使用。
• 扩展 Spring Authorization Server 默认的 Client Credentials 模式，实现真正的使用 Scope 权限对接口进行验证。 增加客户端 Scope 的权限配置功能，并与已有的用户权限体系解耦
• 支持 Spring Authorization Server Authorization Code PKCE 认证模式
• 在 Spring Authorization Server 的标准的 JWT Token 加密校验方式外，支持基于自定义证书的 JWT Token 加密校验方式，可通过配置动态修改。
• 支持 Opaque Token (不透明令牌) 格式及校验方式，降低 JWT Token 被捕获解析的风险。可通过修改配置参数，设置默认 Token 格式是采用 Opaque Token 格式还是 JWT Token 格式。
• 全面支持 OpenID Connect (OIDC) 协议，系统使用时可根据使用需求，通过前端开关配置，快速切换 OIDC 模式和传统 OAuth2 模式
• 深度扩展 Authorization Code、Resource Ownership Password、Social Credentials 几种模式，全面融合 IdToken、Opaque Token、JWT Token 与现有权限体系，同时提供 IdToken 和 自定义 Token 扩展两种无须二次请求的用户信息传递方式，减少用户信息的频繁请求。
• 自定义 Spring Authorization Server 授权码模式登录认证页面和授权确认页面，授权码模式登录采用数据加密传输。支持多种验证码类型，暂不支持行为验证码。
• 新增基于 Spring Authorization Server 的、支持智能电视、IoT等物联网设备认证模式
• 无须在代码中配置 Spring Security 权限注解以及权限方法，即可实现接口鉴权以及权限的动态修改。采用分布式鉴权方案，规避 Gateway 统一鉴权的压力以及重复鉴权问题
• OAuth2 UserDetails 核心数据支持直连数据库获取和 Feign 远程调用两种模式。OAuth2 直连数据库模式性能更优，Feign 访问远程调用可扩展性更强。可通过配置动态修改采用策略方式。

[3]全体系化应用和开发特性集成

• 微服务架构全体系 Session 共享，实现 Spring Authorization Server、多实例服务、WebSocket、自定义 Session 以及大前端 Session 的统一。微服务架构下的 Session 可以选择不用，但是不能没有。
• 混合国密 SM2 (非对称) 和 SM4 (对称加密) 算法，实现基于数字信封技术的秘钥动态生成加密传输。利用“一人一码机制”，实现前后端数据进行动态加密传输与。Spring Authorization Server OAuth 2.1 授权模式深度融合，构建统一体系的数据传输加密。
• 全面整合 @PreAuthorize 注解权限与 URL 权限，通过后端动态配置，无须在代码中配置 Spring Security 权限注解以及权限方法，可实现接口鉴权以及权限的统一管理和动态修改
• 融合 Spring Cloud Stream 和 WebSocket，以优雅的方式实现 WebSocket 服务多实例环境下，点对点、广播消息跨实例推送，在线用户实时统计，完美支持 WebSocket 集群化应用。
• 借鉴 JPA 标准化设计思想，提取和抽象 OSS 标准化操作，形成统一的 Java OSS API 规范。封装可操作任意厂商的、统一的 REST API，构建定义统一、动态实现的应用模式（类似于 Hibernate 是 JPA 的一种实现，Hibernate 以 Dialect 方式支持不同的数据库一样），在不修改代码的情况下通过修改配置实现 OSS 的无缝切换和迁移
• 自研基于 JetCache 分布式两级缓存，完美实现 JPA Hibernate 二级缓存，支持各类查询数据缓存以及 JPA @ManyToMany， @ManyToOne等关联查询。完美解决 Spring Cache 仅使用本地缓存、创建 Key 繁琐和分页数据无法更新的问题。支持多实例服务本地缓存和远程缓存数据同步，同时支持 Mybatis Plus 二级缓存
• 平台统一错误处理，支持自定义错误码体系，有效集成 OAuth2、Spring Validation 等多方错误体系并有机整合 HTTP 状态码。采用 Customizer 模式，采用错误码自动计算和创建模式，支持代码模块级错误码灵活定义扩展。响应结果更加多样灵活，反馈结果也更加人性化，便于理解和定位问题。
• 全体系 OkHttp 、HttpClient 统一化集成，实现 OkHttp 、HttpClient 与 RestTemplate 、Openfeign 一体化融合。统一使用 Feign 配置参数，对 OkHttp 、HttpClient 进行参数设定，可策略化选择设置使用 OkHttp 或 HttpClient 作为 RestTemplate 、Openfeign 统一的基础 HttpClient

[4]采用 pnpm monorepo 重构前端

• 未使用任何流行开源模版，使用全新技术栈，完全纯"手写"全新前端工程。
• 借鉴参考流行开源版本的使用和设计，新版前端界面风格和操作习惯尽量与当前流行方式统一。
• 充份使用 Typescript 语言特性，解决大量类型校验问题，尽可能规避 "any" 式的 Typescript 编程语言使用方式。
• 充份使用 Composition Api 和 Hooks 等 Vue3 框架新版特性进行代码编写。
• 充份利用 Component、Hooks 以及 Typescript 面向对象等特性，抽取通用组件和代码，尽可能降低工程重复代码。
• 对较多 Quasar 基础组件和应用功能组件进行封装，以方便代码的统一修改维护和开发使用。
• 对生产模式下，对基于 Vite3 的工程打包进行深度性能优化。
• 提供以 docker-compose 方式，对工程生产代码进行容器化打包和部署。
• 该版本基于 pnpm，采用 monorepo 模式对前端工程进行重构。构建 monorepo 版本前端，是为扩展更多功能、增加应用级功能做铺垫
• 抽取 utils、components、apis、bpmn-designer 等相关代码，形成共享模块。
• 共享模块已进行优化配置，可编译成独立的组件，单独以组件形式进行发布。
• 代码以共享模块的方式进行单独维护开发，降低现有工程代码复杂度，便于后续功能的扩展和代码的复用。

提示

提问题也是个技术活，想要快速的得到他人的帮助，提问时也要掌握方法和技巧。否则，大概率不会有人愿意帮助你。提问之前好好读读这篇文章，对你对他人都有好处。

目录

• 目录
• 声明
• 简介
• 在提问之前
• 当你提问时
  • 慎选提问的论坛
  • Stack Overflow
  • 网站和 IRC 论坛
  • 第二步，使用项目邮件列表
  • 使用有意义且描述明确的标题
  • 使问题容易回复
  • 使用清晰、正确、精准且合乎语法的语句
  • 使用易于读取且标准的文件格式发送问题
  • 精确地描述问题并言之有物
  • 话不在多而在精
  • 别动辄声称找到 Bug
  • 低声下气不能代替你的功课
  • 描述问题症状而非你的猜测
  • 按发生时间先后列出问题症状
  • 描述目标而不是过程
  • 别要求使用私人电邮回复
  • 清楚明确地表达你的问题以及需求
  • 询问有关代码的问题时
  • 别把自己家庭作业的问题贴上来
  • 去掉无意义的提问句
  • 即使你很急也不要在标题写紧急
  • 礼多人不怪，而且有时还很有帮助
  • 问题解决后，加个简短的补充说明
• 如何解读答案
  • RTFM 和 STFW：如何知道你已完全搞砸了
  • 如果还是搞不懂
  • 处理无礼的回应
• 如何避免扮演失败者
• 不该问的问题
• 好问题与蠢问题
• 如果得不到回答
• 如何更好地回答问题
• 相关资源
• 鸣谢

声明

许多项目在他们网站的帮助文档中链接了本指南。这很好，这正是我们想要的用途。但如果你是该项目管理员并试图创建指向本指南的超链接，请在超链接附近的显著位置注明：

本指南不提供此项目的实际支持服务！

我们已经深刻领教到缺少上述声明所带来的痛苦：我们将不停地被那些认为发布这本指南就意味着有责任解决世上所有技术问题的傻瓜苦苦纠缠。

如果你因寻求某些帮助而阅读本指南，并在离开时还觉得可以从本文作者这里得到直接帮助，那你就是我们之前说的那些傻瓜之一。别问我们问题，我们只会忽略你。我们在这本指南中想教你如何从那些真正懂得你所遇到的软件或硬件问题的人处取得协助，而 99% 的情况下那不会是我们。除非你确定本指南的作者之一刚好是你所遇到的问题领域的专家，否则请不要打扰我们，这样大家都会开心一点。

简介

在黑客的世界里，你所提技术问题的解答的好坏, 很大程度上取决于你提问的方式与此问题的难度。本指南将教你如何正确地提问以获得你满意的答案。

现在开源（Open Source）软件已经相当盛行，您通常可以从其他更有经验的用户那里获得与黑客一样好的答案，这是件好事；和黑客相比，用户们往往对那些新手常遇到的问题更宽容一些。尽管如此，以我们在此推荐的方式对待这些有经验的用户通常也是从他们那里获得有用答案的最有效方式。

首先你应该明白，黑客们喜爱有挑战性的问题，或者能激发他们思维的好问题。如果我们并非如此，那我们也不会成为你想询问的对象。如果你给了我们一个值得反复咀嚼玩味的好问题，我们自会对你感激不尽。好问题是激励，是厚礼。好问题可以提高我们的理解力，而且通常会暴露我们以前从没意识到或者思考过的问题。对黑客而言，“好问题！”是诚挚的大力称赞。

尽管如此，黑客们有着蔑视或傲慢面对简单问题的坏名声，这有时让我们看起来对新手、无知者似乎较有敌意，但其实不是那样的。

我们不讳言我们对那些不愿思考、或者在发问前不做他们该做的事的人的蔑视。那些人是时间杀手 —— 他们只想索取，从不付出，消耗我们可用在更有趣的问题或更值得回答的人身上的时间。我们称这样的人为 失败者（loser） （由于历史原因，我们有时把它拼作 lusers）。

我们意识到许多人只是想使用我们写的软件，他们对学习技术细节没有兴趣。对大多数人而言，电脑只是种工具，是种达到目的的手段而已。他们有自己的生活并且有更要紧的事要做。我们认可这点，也从不指望每个人都对这些让我们着迷的技术问题感兴趣。尽管如此，我们只为那些真正有兴趣并愿意积极参与问题解决的人调整回答问题的风格。这点不会变，也不该变：否则，我们就是在最擅长的事情上降低效率。

我们（在很大程度上）是自愿的，从繁忙的生活中抽出时间来解答疑惑，而且时常被提问淹没。所以我们无情地滤掉一些话题，特别是拋弃那些看起来像失败者的家伙，以便更高效地利用时间来回答赢家（winner）的问题。

如果你厌恶我们的态度，高高在上，或过于傲慢，不妨也设身处地想想。我们并没有要求你向我们屈服 —— 事实上，我们大多数人非常乐意与你平等地交流，只要你付出小小努力来满足基本要求，我们就会欢迎你加入我们的文化。但让我们帮助那些不愿意帮助自己的人是没有效率的。无知没有关系，但装白痴就是不行。

所以，你不必在技术上很在行才能吸引我们的注意，但你必须表现出能引导你变得在行的特质 —— 机敏、有想法、善于观察、乐于主动参与解决问题。如果你做不到这些使你与众不同的事情，我们建议你花点钱找家商业公司签个技术支持服务合同，而不是要求黑客个人无偿地帮助你。

如果你决定向我们求助，当然你也不希望被视为失败者，更不愿成为失败者中的一员。能立刻得到快速并有效答案的最好方法，就是像赢家那样提问 —— 聪明、自信、有解决问题的思路，只是偶尔在特定的问题上需要获得一点帮助。

（欢迎对本指南提出改进意见。你可以把你的建议发送至 esr@thyrsus.com 或 respond-auto@linuxmafia.com。然而请注意，本文并非网络礼节的通用指南，而我们通常会拒绝无助于在技术论坛得到有用答案的建议）。

在提问之前

在你准备要通过电子邮件、新闻群组或者聊天室提出技术问题前，请先做到以下事情：

1. 尝试在你准备提问的论坛的旧文章中搜索答案。
2. 尝试上网搜索以找到答案。
3. 尝试阅读手册以找到答案。
4. 尝试阅读常见问题文件（FAQ）以找到答案。
5. 尝试自己检查或试验以找到答案。
6. 向你身边的强者朋友打听以找到答案。
7. 如果你是程序开发者，请尝试阅读源代码以找到答案。

当你提出问题的时候，请先表明你已经做了上述的努力；这将有助于树立你并不是一个不劳而获且浪费别人的时间的提问者。如果你能一并表达在做了上述努力的过程中所学到的东西会更好，因为我们更乐于回答那些表现出能从答案中学习的人的问题。

运用某些策略，比如先用 Google 搜索你所遇到的各种错误信息（搜索 Google 论坛和网页），这样很可能直接就找到了能解决问题的文件或邮件列表线索。即使没有结果，在邮件列表或新闻组寻求帮助时加上一句 我在 Google 中搜过下列句子但没有找到什么有用的东西 也是件好事，即使它只是表明了搜索引擎不能提供哪些帮助。这么做（加上搜索过的字串）也让遇到相似问题的其他人能被搜索引擎引导到你的提问来。

别着急，不要指望几秒钟的 Google 搜索就能解决一个复杂的问题。在向专家求助之前，再阅读一下常见问题文件（FAQ）、放轻松、坐得舒服一些，再花点时间思考一下这个问题。相信我们，他们能从你的提问看出你做了多少阅读与思考，如果你是有备而来，将更有可能得到解答。不要将所有问题一股脑拋出，只因你的第一次搜索没有找到答案（或者找到太多答案）。

准备好你的问题，再将问题仔细地思考过一遍，因为草率的发问只能得到草率的回答，或者根本得不到任何答案。越是能表现出在寻求帮助前你为解决问题所付出的努力，你越有可能得到实质性的帮助。

小心别问错了问题。如果你的问题基于错误的假设，某个普通黑客（J. Random Hacker）多半会一边在心里想着蠢问题…，一边用无意义的字面解释来答复你，希望着你会从问题的回答（而非你想得到的答案）中汲取教训。

绝不要自以为够格得到答案，你没有；你并没有。毕竟你没有为这种服务支付任何报酬。你将会是自己去挣到一个答案，靠提出有内涵的、有趣的、有思维激励作用的问题 —— 一个有潜力能贡献社区经验的问题，而不仅仅是被动地从他人处索取知识。

另一方面，表明你愿意在找答案的过程中做点什么是一个非常好的开端。谁能给点提示？、我的这个例子里缺了什么？以及我应该检查什么地方比请把我需要的确切的过程贴出来更容易得到答复。因为你表现出只要有人能指个正确方向，你就有完成它的能力和决心。

当你提问时

慎选提问的论坛

小心选择你要提问的场合。如果你做了下述的事情，你很可能被忽略掉或者被看作失败者：

• 在与主题不合的论坛上贴出你的问题。
• 在探讨进阶技术问题的论坛张贴非常初级的问题；反之亦然。
• 在太多的不同新闻群组上重复转贴同样的问题（cross-post）。
• 向既非熟人也没有义务解决你问题的人发送私人电邮。

黑客会剔除掉那些搞错场合的问题，以保护他们沟通的渠道不被无关的东西淹没。你不会想让这种事发生在自己身上的。

因此，第一步是找到对的论坛。再说一次，Google 和其它搜索引擎还是你的朋友，用它们来找到与你遭遇到困难的软硬件问题最相关的网站。通常那儿都有常见问题（FAQ）、邮件列表及相关说明文件的链接。如果你的努力（包括阅读 FAQ）都没有结果，网站上也许还有报告 Bug（Bug-reporting）的流程或链接，如果是这样，链过去看看。

向陌生的人或论坛发送邮件最可能是风险最大的事情。举例来说，别假设一个提供丰富内容的网页的作者会想充当你的免费顾问。不要对你的问题是否会受到欢迎做太乐观的估计 —— 如果你不确定，那就向别处发送，或者压根别发。

在选择论坛、新闻群组或邮件列表时，别太相信它的名字，先看看 FAQ 或者许可书以弄清楚你的问题是否切题。发文前先翻翻已有的话题，这样可以让你感受一下那里的文化。事实上，事先在新闻组或邮件列表的历史记录中搜索与你问题相关的关键词是个极好的主意，也许这样就找到答案了。即使没有，也能帮助你归纳出更好的问题。

别像机关枪似的一次“扫射”所有的帮助渠道，这就像大喊大叫一样会使人不快。要一个一个地来。

搞清楚你的主题！最典型的错误之一是在某种致力于跨平台可移植的语言、套件或工具的论坛中提关于 Unix 或 Windows 操作系统程序界面的问题。如果你不明白为什么这是大错，最好在搞清楚这之间差异之前什么也别问。

一般来说，在仔细挑选的公共论坛中提问，会比在私有论坛中提同样的问题更容易得到有用的回答。有几个理由可以支持这点，一是看潜在的回复者有多少，二是看观众有多少。黑客较愿意回答那些能帮助到许多人的问题。

可以理解的是，老练的黑客和一些热门软件的作者正在接受过多的错发信息。就像那根最后压垮骆驼背的稻草一样，你的加入也有可能使情况走向极端 —— 已经好几次了，一些热门软件的作者由于涌入其私人邮箱的大量不堪忍受的无用邮件而不再提供支持。

Stack Overflow

搜索，然后在 Stack Exchange 问。

近年来，Stack Exchange 社区已经成为回答技术及其他问题的主要渠道，尤其是那些开放源码的项目。

因为 Google 索引是即时的，在看 Stack Exchange 之前先在 Google 搜索。有很高的几率某人已经问了一个类似的问题，而且 Stack Exchange 网站们往往会是搜索结果中最前面几个。如果你在 Google 上没有找到任何答案，你再到特定相关主题的网站去找。用标签（Tag）搜索能让你更缩小你的搜索结果。

如果你还是找不到任何对你的问题有用的内容，请把你的问题发在与它最相关的网站上。提问的时候请善用格式化工具，尤其注意为代码添加格式，并且添加相关的标签（特别是编程语言、操作系统或库/包的名称）。当有人要求你提供更多相关信息时，请编辑你的贴子来补充它们[译注：而不是发一个回帖或回答！]。如果你觉得一个答案对你有帮助，点击向上的箭头来为它投票；如果一个答案提供了问题的正确解决方案，点击投票按钮下方的对勾来将它标记为正解。

Stack Exchange 已经成长到超过一百个网站，以下是最常用的几个站：

• Super User 是问一些通用的电脑问题，如果你的问题跟代码或是写程序无关，只是一些网络连线之类的，请到这里。
• Stack Overflow 是问写程序有关的问题。
• Server Fault 是问服务器和网管相关的问题。

网站和 IRC 论坛

本地的用户群组（user group），或者你所用的 Linux 发行版本也许正在宣传他们的网页论坛或 IRC 频道，并提供新手帮助（在一些非英语国家，新手论坛很可能还是邮件列表），这些都是开始提问的好地方，特别是当你觉得遇到的也许只是相对简单或者很普通的问题时。有广告赞助的 IRC 频道是公开欢迎提问的地方，通常可以即时得到回应。

事实上，如果程序出的问题只发生在特定 Linux 发行版提供的版本（这很常见），最好先去该发行版的论坛或邮件列表中提问，再到程序本身的论坛或邮件列表提问。（否则）该项目的黑客可能仅仅回复“使用我们的版本”。

在任何论坛发文以前，先确认一下有没有搜索功能。如果有，就试着搜索一下问题的几个关键词，也许这会有帮助。如果在此之前你已做过通用的网页搜索（你也该这样做），还是再搜索一下论坛，搜索引擎有可能没来得及索引此论坛的全部内容。

通过论坛或 IRC 频道来提供用户支持服务有增长的趋势，电子邮件则大多为项目开发者间的交流而保留。所以最好先在论坛或 IRC 中寻求与该项目相关的协助。

在使用 IRC 的时候，首先最好不要发布很长的问题描述，有些人称之为频道洪水。最好通过一句话的问题描述来开始聊天。

第二步，使用项目邮件列表

当某个项目提供开发者邮件列表时，要向列表而不是其中的个别成员提问，即使你确信他能最好地回答你的问题。查一查项目的文件和首页，找到项目的邮件列表并使用它。有几个很好的理由支持我们采用这种办法：

• 任何好到需要向个别开发者提出的问题，也将对整个项目群组有益。反之，如果你认为自己的问题对整个项目群组来说太愚蠢，那这也不能成为骚扰个别开发者的理由。
• 向列表提问可以分散开发者的负担，个别开发者（尤其是项目领导人）也许太忙以至于没法回答你的问题。
• 大多数邮件列表都会被存档，那些被存档的内容将被搜索引擎索引。如果你向列表提问并得到解答，将来其他人可以通过网页搜索找到你的问题和答案，也就不用再次发问了。
• 如果某些问题经常被问到，开发者可以利用此信息来改进说明文件或软件本身，以使其更清楚。如果只是私下提问，就没有人能看到最常见问题的完整场景。

如果一个项目既有“用户”也有“开发者”（或“黑客”）邮件列表或论坛，而你又不会动到那些源代码，那么就向“用户”列表或论坛提问。不要假设自己会在开发者列表中受到欢迎，那些人多半会将你的提问视为干扰他们开发的噪音。

然而，如果你确信你的问题很特别，而且在“用户”列表或论坛中几天都没有回复，可以试试前往“开发者”列表或论坛发问。建议你在张贴前最好先暗地里观察几天以了解那里的行事方式（事实上这是参与任何私有或半私有列表的好主意）

如果你找不到一个项目的邮件列表，而只能查到项目维护者的电子邮件地址，尽管向他发信。即使是在这种情况下，也别假设（项目）邮件列表不存在。在你的电子邮件中，请陈述你已经试过但没有找到合适的邮件列表，也提及你不反对将自己的邮件转发给他人（许多人认为，即使没什么秘密，私人电子邮件也不应该被公开。通过允许将你的电子邮件转发他人，你给了相应人员处置你邮件的选择）。

使用有意义且描述明确的标题

在邮件列表、新闻群组或论坛中，大约 50 字以内的标题是抓住资深专家注意力的好机会。别用喋喋不休的帮帮忙、跪求、急（更别说救命啊！！！！这样让人反感的话，用这种标题会被条件反射式地忽略）来浪费这个机会。不要妄想用你的痛苦程度来打动我们，而应该是在这点空间中使用极简单扼要的描述方式来提出问题。

一个好标题范例是目标 —— 差异式的描述，许多技术支持组织就是这样做的。在目标部分指出是哪一个或哪一组东西有问题，在差异部分则描述与期望的行为不一致的地方。

蠢问题：救命啊！我的笔记本电脑不能正常显示了！

聪明问题：X.org 6.8.1 的鼠标指针会变形，某牌显卡 MV1005 芯片组。

更聪明问题：X.org 6.8.1 的鼠标指针，在某牌显卡 MV1005 芯片组环境下 - 会变形。

编写目标 —— 差异 式描述的过程有助于你组织对问题的细致思考。是什么被影响了？ 仅仅是鼠标指针或者还有其它图形？只在 X.org 的 X 版中出现？或只是出现在 6.8.1 版中？ 是针对某牌显卡芯片组？或者只是其中的 MV1005 型号？ 一个黑客只需瞄一眼就能够立即明白你的环境和你遇到的问题。

总而言之，请想像一下你正在一个只显示标题的存档讨论串（Thread）索引中查寻。让你的标题更好地反映问题，可使下一个搜索类似问题的人能够关注这个讨论串，而不用再次提问相同的问题。

如果你想在回复中提出问题，记得要修改内容标题，以表明你是在问一个问题， 一个看起来像 Re: 测试 或者 Re: 新 bug 的标题很难引起足够重视。另外，在不影响连贯性之下，适当引用并删减前文的内容，能给新来的读者留下线索。

对于讨论串，不要直接点击回复来开始一个全新的讨论串，这将限制你的观众。因为有些邮件阅读程序，比如 mutt ，允许用户按讨论串排序并通过折叠讨论串来隐藏消息，这样做的人永远看不到你发的消息。

仅仅改变标题还不够。mutt 和其它一些邮件阅读程序还会检查邮件标题以外的其它信息，以便为其指定讨论串。所以宁可发一个全新的邮件。

在网页论坛上，好的提问方式稍有不同，因为讨论串与特定的信息紧密结合，并且通常在讨论串外就看不到里面的内容，故通过回复提问，而非改变标题是可接受的。不是所有论坛都允许在回复中出现分离的标题，而且这样做了基本上没有人会去看。不过，通过回复提问，这本身就是暧昧的做法，因为它们只会被正在查看该标题的人读到。所以，除非你只想在该讨论串当前活跃的人群中提问，不然还是另起炉灶比较好。

使问题容易回复

以请将你的回复发送到……来结束你的问题多半会使你得不到回答。如果你觉得花几秒钟在邮件客户端设置一下回复地址都麻烦，我们也觉得花几秒钟思考你的问题更麻烦。如果你的邮件程序不支持这样做，换个好点的；如果是操作系统不支持这种邮件程序，也换个好点的。

在论坛，要求通过电子邮件回复是非常无礼的，除非你认为回复的信息可能比较敏感（有人会为了某些未知的原因，只让你而不是整个论坛知道答案）。如果你只是想在有人回复讨论串时得到电子邮件提醒，可以要求网页论坛发送给你。几乎所有论坛都支持诸如追踪此讨论串、有回复时发送邮件提醒等功能。

使用清晰、正确、精准且合乎语法的语句

我们从经验中发现，粗心的提问者通常也会粗心地写程序与思考（我敢打包票）。回答粗心大意者的问题很不值得，我们宁愿把时间耗在别处。

正确的拼写、标点符号和大小写是很重要的。一般来说，如果你觉得这样做很麻烦，不想在乎这些，那我们也觉得麻烦，不想在乎你的提问。花点额外的精力斟酌一下字句，用不着太僵硬与正式 —— 事实上，黑客文化很看重能准确地使用非正式、俚语和幽默的语句。但它必须很准确，而且有迹象表明你是在思考和关注问题。

正确地拼写、使用标点和大小写，不要将its混淆为it's，loose搞成lose或者将discrete弄成discreet。不要全部用大写，这会被视为无礼的大声嚷嚷（全部小写也好不到哪去，因为不易阅读。Alan Cox 也许可以这样做，但你不行）。

更白话的说，如果你写得像是个半文盲[译注：小白]，那多半得不到理睬。也不要使用即时通信中的简写或火星文，如将的简化为d会使你看起来像一个为了少打几个键而省字的小白。更糟的是，如果像个小孩似地鬼画符那绝对是在找死，可以肯定没人会理你（或者最多是给你一大堆指责与挖苦）。

如果在使用非母语的论坛提问，你可以犯点拼写和语法上的小错，但决不能在思考上马虎（没错，我们通常能弄清两者的分别）。同时，除非你知道回复者使用的语言，否则请使用英语书写。繁忙的黑客一般会直接删除用他们看不懂的语言写的消息。在网络上英语是通用语言，用英语书写可以将你的问题在尚未被阅读就被直接删除的可能性降到最低。

如果英文是你的外语（Second language），提示潜在回复者你有潜在的语言困难是很好的：
[译注：以下附上原文以供使用]

English is not my native language; please excuse typing errors.

• 英文不是我的母语，请原谅我的错字或语法。

If you speak $LANGUAGE, please email/PM me;
I may need assistance translating my question.

• 如果你说某语言，请向我发电邮/私信；
• 我需要有人协助我翻译我的问题。

I am familiar with the technical terms,
but some slang expressions and idioms are difficult for me.

• 我对技术名词很熟悉，但对于俗语或是特别用法不甚了解。

I've posted my question in $LANGUAGE and English.
I'll be glad to translate responses, if you only use one or the other.

• 我把我的问题用某语言和英文写出来。
• 如果你只用其中的一种语言回答，我会乐意将回复翻译成为你使用的语言。

使用易于读取且标准的文件格式发送问题

如果你人为地将问题搞得难以阅读，它多半会被忽略，人们更愿读易懂的问题，所以：

• 使用纯文字而不是 HTML (关闭 HTML 并不难）。
• 使用 MIME 附件通常是可以的，前提是真正有内容（譬如附带的源代码或 patch），而不仅仅是邮件程序生成的模板（譬如只是信件内容的拷贝）。
• 不要发送一段文字只是一行句子但自动换行后会变成多行的邮件（这使得回复部分内容非常困难）。设想你的读者是在 80 个字符宽的终端机上阅读邮件，最好设置你的换行分割点小于 80 字。
• 但是，对一些特殊的文件不要设置固定宽度（譬如日志文件拷贝或会话记录）。数据应该原样包含，让回复者有信心他们看到的是和你看到的一样的东西。
• 在英语论坛中，不要使用Quoted-Printable MIME 编码发送消息。这种编码对于张贴非 ASCII 语言可能是必须的，但很多邮件程序并不支持这种编码。当它们处理换行时，那些文本中四处散布的=20符号既难看也分散注意力，甚至有可能破坏内容的语意。
• 绝对，永远不要指望黑客们阅读使用封闭格式编写的文档，像微软公司的 Word 或 Excel 文件等。大多数黑客对此的反应就像有人将还在冒热气的猪粪倒在你家门口时你的反应一样。即便他们能够处理，他们也很厌恶这么做。
• 如果你从使用 Windows 的电脑发送电子邮件，关闭微软愚蠢的智能引号功能 （从[选项] > [校订] > [自动校正选项]，勾选掉智能引号单选框），以免在你的邮件中到处散布垃圾字符。
• 在论坛，勿滥用表情符号和HTML功能（当它们提供时）。一两个表情符号通常没有问题，但花哨的彩色文本倾向于使人认为你是个无能之辈。过滥地使用表情符号、色彩和字体会使你看来像个傻笑的小姑娘。这通常不是个好主意，除非你只是对性而不是对答案感兴趣。

如果你使用图形用户界面的邮件程序（如微软公司的 Outlook 或者其它类似的），注意它们的默认设置不一定满足这些要求。大多数这类程序有基于选单的查看源代码命令，用它来检查发送文件夹中的邮件，以确保发送的是纯文本文件同时没有一些奇怪的字符。

精确地描述问题并言之有物

• 仔细、清楚地描述你的问题或 Bug 的症状。
• 描述问题发生的环境（机器配置、操作系统、应用程序、以及相关的信息），提供经销商的发行版和版本号（如：Fedora Core 4、Slackware 9.1等）。
• 描述在提问前你是怎样去研究和理解这个问题的。
• 描述在提问前为确定问题而采取的诊断步骤。
• 描述最近做过什么可能相关的硬件或软件变更。
• 尽可能地提供一个可以重现这个问题的可控环境的方法。

尽量去揣测一个黑客会怎样反问你，在你提问之前预先将黑客们可能提出的问题回答一遍。

以上几点中，当你报告的是你认为可能在代码中的问题时，给黑客一个可以重现你的问题的环境尤其重要。当你这么做时，你得到有效的回答的机会和速度都会大大的提升。

Simon Tatham 写过一篇名为《如何有效地报告Bug》的出色文章。强力推荐你也读一读。

话不在多而在精

你需要提供精确有内容的信息。这并不是要求你简单的把成堆的出错代码或者资料完全转录到你的提问中。如果你有庞大而复杂的测试样例能重现程序挂掉的情境，尽量将它剪裁得越小越好。

这样做的用处至少有三点。
第一，表现出你为简化问题付出了努力，这可以使你得到回答的机会增加；
第二，简化问题使你更有可能得到有用的答案；
第三，在精炼你的 bug 报告的过程中，你很可能就自己找到了解决方法或权宜之计。

别动辄声称找到 Bug

当你在使用软件中遇到问题，除非你非常、非常的有根据，不要动辄声称找到了 Bug。提示：除非你能提供解决问题的源代码补丁，或者提供回归测试来表明前一版本中行为不正确，否则你都多半不够完全确信。这同样适用在网页和文件，如果你（声称）发现了文件的Bug，你应该能提供相应位置的修正或替代文件。

请记得，还有其他许多用户没遇到你发现的问题，否则你在阅读文件或搜索网页时就应该发现了（你在抱怨前已经做了这些，是吧？）。这也意味着很有可能是你弄错了而不是软件本身有问题。

编写软件的人总是非常辛苦地使它尽可能完美。如果你声称找到了 Bug，也就是在质疑他们的能力，即使你是对的，也有可能会冒犯到其中某部分人。当你在标题中嚷嚷着有Bug时，这尤其严重。

提问时，即使你私下非常确信已经发现一个真正的 Bug，最好写得像是你做错了什么。如果真的有 Bug，你会在回复中看到这点。这样做的话，如果真有 Bug，维护者就会向你道歉，这总比你惹恼别人然后欠别人一个道歉要好一点。

低声下气不能代替你的功课

有些人明白他们不该粗鲁或傲慢的提问并要求得到答复，但他们选择另一个极端 —— 低声下气：我知道我只是个可悲的新手，一个失败者，但...。这既使人困扰，也没有用，尤其是伴随着与实际问题含糊不清的描述时更令人反感。

别用原始灵长类动物的把戏来浪费你我的时间。取而代之的是，尽可能清楚地描述背景条件和你的问题情况。这比低声下气更好地定位了你的位置。

有时网页论坛会设有专为新手提问的版面，如果你真的认为遇到了初学者的问题，到那去就是了，但一样别那么低声下气。

描述问题症状而非你的猜测

告诉黑客们你认为问题是怎样造成的并没什么帮助。（如果你的推断如此有效，还用向别人求助吗？），因此要确信你原原本本告诉了他们问题的症状，而不是你的解释和理论；让黑客们来推测和诊断。如果你认为陈述自己的猜测很重要，清楚地说明这只是你的猜测，并描述为什么它们不起作用。

蠢问题

我在编译内核时接连遇到 SIG11 错误，
我怀疑某条飞线搭在主板的走线上了，这种情况应该怎样检查最好？

聪明问题

我的组装电脑是 FIC-PA2007 主机板搭载 AMD K6/233 CPU（威盛 Apollo VP2 芯片组），
256MB Corsair PC133 SDRAM 内存，在编译内核时，从开机 20 分钟以后就频频产生 SIG11 错误，
但是在头 20 分钟内从没发生过相同的问题。重新启动也没有用，但是关机一晚上就又能工作 20 分钟。
所有内存都换过了，没有效果。相关部分的标准编译记录如下…

由于以上这点似乎让许多人觉得难以配合，这里有句话可以提醒你：所有的诊断专家都来自密苏里州。 美国国务院的官方座右铭则是：让我看看（出自国会议员 Willard D. Vandiver 在 1899 年时的讲话：我来自一个出产玉米，棉花，牛蒡和民主党人的国家，滔滔雄辩既不能说服我，也不会让我满意。我来自密苏里州，你必须让我看看。） 针对诊断者而言，这并不是一种怀疑，而只是一种真实而有用的需求，以便让他们看到的是与你看到的原始证据尽可能一致的东西，而不是你的猜测与归纳的结论。所以，大方地展示给我们看吧！

按发生时间先后列出问题症状

问题发生前的一系列操作，往往就是对找出问题最有帮助的线索。因此，你的说明里应该包含你的操作步骤，以及机器和软件的反应，直到问题发生。在命令行处理的情况下，提供一段操作记录（例如运行脚本工具所生成的），并引用相关的若干行（如 20 行）记录会非常有帮助。

如果挂掉的程序有诊断选项（如 -v 的详述开关），试着选择这些能在记录中增加调试信息的选项。记住，多不等于好。试着选取适当的调试级别以便提供有用的信息而不是让读者淹没在垃圾中。

如果你的说明很长（如超过四个段落），在开头简述问题，接下来再按时间顺序详述会有所帮助。这样黑客们在读你的记录时就知道该注意哪些内容了。

描述目标而不是过程

如果你想弄清楚如何做某事（而不是报告一个 Bug），在开头就描述你的目标，然后才陈述重现你所卡住的特定步骤。

经常寻求技术帮助的人在心中有个更高层次的目标，而他们在自以为能达到目标的特定道路上被卡住了，然后跑来问该怎么走，但没有意识到这条路本身就有问题。结果要费很大的劲才能搞定。

蠢问题

我怎样才能从某绘图程序的颜色选择器中取得十六进制的 RGB 值？

聪明问题

我正试着用替换一幅图片的色码（color table）成自己选定的色码，我现在知道的唯一方法是编辑每个色码区块（table slot），
但却无法从某绘图程序的颜色选择器取得十六进制的 RGB 值。

第二种提问法比较聪明，你可能得到像是建议采用另一个更合适的工具的回复。

别要求使用私人电邮回复

黑客们认为问题的解决过程应该公开、透明，此过程中如果更有经验的人注意到不完整或者不当之处，最初的回复才能够、也应该被纠正。同时，作为提供帮助者可以得到一些奖励，奖励就是他的能力和学识被其他同行看到。

当你要求私下回复时，这个过程和奖励都被中止。别这样做，让回复者来决定是否私下回答 —— 如果他真这么做了，通常是因为他认为问题编写太差或者太肤浅，以至于不可能使其他人产生兴趣。

这条规则存在一条有限的例外，如果你确信提问可能会引来大量雷同的回复时，那么这个神奇的提问句会是向我发电邮，我将为论坛归纳这些回复。试着将邮件列表或新闻群组从洪水般的雷同回复中解救出来是非常有礼貌的 —— 但你必须信守诺言。

清楚明确地表达你的问题以及需求

漫无边际的提问是近乎无休无止的时间黑洞。最有可能给你有用答案的人通常也正是最忙的人（他们忙是因为要亲自完成大部分工作）。这样的人对无节制的时间黑洞相当厌恶，所以他们也倾向于厌恶那些漫无边际的提问。

如果你明确表述需要回答者做什么（如提供指点、发送一段代码、检查你的补丁、或是其他等等），就最有可能得到有用的答案。因为这会定出一个时间和精力的上限，便于回答者能集中精力来帮你。这么做很棒。

要理解专家们所处的世界，请把专业技能想像为充裕的资源，而回复的时间则是稀缺的资源。你要求他们奉献的时间越少，你越有可能从真正专业而且很忙的专家那里得到解答。

所以，界定一下你的问题，使专家花在辨识你的问题和回答所需要付出的时间减到最少，这技巧对你获得有用的答案相当有帮助 —— 但这技巧通常和简化问题有所区别。因此，问我想更好地理解 X，可否指点一下哪有好一点说明？通常比问你能解释一下 X 吗？更好。如果你的代码不能运作，通常请别人看看哪里有问题，比要求别人替你改正要明智得多。

询问有关代码的问题时

如果没有提示别人应该从何入手，别要求他人帮你调试有问题的代码。张贴几百行的代码，然后说一声：它不能工作会让你完全被忽略。只贴几十行代码，然后说一句：在第七行以后，我期待它显示 <x>，但实际出现的是 <y>比较有可能让你得到回应。

最有效描述程序问题的方法是提供最精简的 Bug 展示测试用例（bug-demonstrating test case）。什么是最精简的测试用例？那是问题的缩影；一小个程序片段能刚好展示出程序的异常行为，而不包含其他令人分散注意力的内容。怎么制作最精简的测试用例？如果你知道哪一行或哪一段代码会造成异常的行为，复制下来并加入足够重现这个状况的代码（例如，足以让这段代码能被编译/直译/被应用程序处理）。如果你无法将问题缩减到一个特定区块，就复制一份代码并移除不影响产生问题行为的部分。总之，测试用例越小越好（查看话不在多而在精一节）。

一般而言，要得到一段相当精简的测试用例并不太容易，但永远先尝试这样做是一个好习惯。这种方式可以帮助你了解如何自行解决这个问题 —— 而且即使你的尝试不成功，黑客们也会看到你在尝试取得答案的过程中付出了努力，这可以让他们更愿意与你合作。

如果你只是想让别人帮忙审查（Review）一下代码，在信的开头就要说出来，并且一定要提到你认为哪一部分特别需要关注以及为什么。

别把自己家庭作业的问题贴上来

黑客们很擅长分辨哪些问题是家庭作业式的问题；因为我们中的大多数都曾自己解决这类问题。同样，这些问题得由你来搞定，你会从中学到东西。你可以要求给点提示，但别要求得到完整的解决方案。

如果你怀疑自己碰到了一个家庭作业式的问题，但仍然无法解决，试试在用户群组，论坛或（最后一招）在项目的用户邮件列表或论坛中提问。尽管黑客们会看出来，但一些有经验的用户也许仍会给你一些提示。

去掉无意义的提问句

避免用无意义的话结束提问，例如有人能帮我吗？或者这有答案吗？。

首先：如果你对问题的描述不是很好，这样问更是画蛇添足。

其次：由于这样问是画蛇添足，黑客们会很厌烦你 —— 而且通常会用逻辑上正确，但毫无意义的回答来表示他们的蔑视， 例如：没错，有人能帮你或者不，没答案。

一般来说，避免用 是或否、对或错、有或没有类型的问句，除非你想得到是或否类型的回答。

即使你很急也不要在标题写紧急

这是你的问题，不是我们的。宣称紧急极有可能事与愿违：大多数黑客会直接删除无礼和自私地企图即时引起关注的问题。更严重的是，紧急这个字（或是其他企图引起关注的标题）通常会被垃圾信过滤器过滤掉 —— 你希望能看到你问题的人可能永远也看不到。

有半个例外的情况是，如果你是在一些很高调，会使黑客们兴奋的地方，也许值得这样去做。在这种情况下，如果你有时间压力，也很有礼貌地提到这点，人们也许会有兴趣回答快一点。

当然，这风险很大，因为黑客们兴奋的点多半与你的不同。譬如从 NASA 国际空间站（International Space Station）发这样的标题没有问题，但用自我感觉良好的慈善行为或政治原因发肯定不行。事实上，张贴诸如紧急：帮我救救这个毛茸茸的小海豹！肯定让你被黑客忽略或惹恼他们，即使他们认为毛茸茸的小海豹很重要。

如果你觉得这点很不可思议，最好再把这份指南剩下的内容多读几遍，直到你弄懂了再发文。

礼多人不怪，而且有时还很有帮助

彬彬有礼，多用请和谢谢您的关注，或谢谢你的关照。让大家都知道你对他们花时间免费提供帮助心存感激。

坦白说，这一点并没有比使用清晰、正确、精准且合乎语法和避免使用专用格式重要（也不能取而代之）。黑客们一般宁可读有点唐突但技术上鲜明的 Bug 报告，而不是那种有礼但含糊的报告。（如果这点让你不解，记住我们是按问题能教给我们什么来评价问题的价值的）

然而，如果你有一串的问题待解决，客气一点肯定会增加你得到有用回应的机会。

（我们注意到，自从本指南发布后，从资深黑客那里得到的唯一严重缺陷反馈，就是对预先道谢这一条。一些黑客觉得先谢了意味着事后就不用再感谢任何人的暗示。我们的建议是要么先说先谢了，然后事后再对回复者表示感谢，或者换种方式表达感激，譬如用谢谢你的关注或谢谢你的关照。）

问题解决后，加个简短的补充说明

问题解决后，向所有帮助过你的人发个说明，让他们知道问题是怎样解决的，并再一次向他们表示感谢。如果问题在新闻组或者邮件列表中引起了广泛关注，应该在那里贴一个说明比较恰当。

最理想的方式是向最初提问的话题回复此消息，并在标题中包含已修正，已解决或其它同等含义的明显标记。在人来人往的邮件列表里，一个看见讨论串问题 X和问题 X - 已解决的潜在回复者就明白不用再浪费时间了（除非他个人觉得问题 X有趣），因此可以利用此时间去解决其它问题。

补充说明不必很长或是很深入；简单的一句你好，原来是网线出了问题！谢谢大家 – Bill比什么也不说要来的好。事实上，除非结论真的很有技术含量，否则简短可爱的小结比长篇大论更好。说明问题是怎样解决的，但大可不必将解决问题的过程复述一遍。

对于有深度的问题，张贴调试记录的摘要是有帮助的。描述问题的最终状态，说明是什么解决了问题，在此之后才指明可以避免的盲点。避免盲点的部分应放在正确的解决方案和其它总结材料之后，而不要将此信息搞成侦探推理小说。列出那些帮助过你的名字，会让你交到更多朋友。

除了有礼貌和有内涵以外，这种类型的补充也有助于他人在邮件列表/新闻群组/论坛中搜索到真正解决你问题的方案，让他们也从中受益。

至少，这种补充有助于让每位参与协助的人因问题的解决而从中得到满足感。如果你自己不是技术专家或者黑客，那就相信我们，这种感觉对于那些你向他们求助的大师或者专家而言，是非常重要的。问题悬而未决会让人灰心；黑客们渴望看到问题被解决。好人有好报，满足他们的渴望，你会在下次提问时尝到甜头。

思考一下怎样才能避免他人将来也遇到类似的问题，自问写一份文件或加个常见问题（FAQ）会不会有帮助。如果是的话就将它们发给维护者。

在黑客中，这种良好的后继行动实际上比传统的礼节更为重要，也是你如何透过善待他人而赢得声誉的方式，这是非常有价值的资产。

如何解读答案

RTFM 和 STFW：如何知道你已完全搞砸了

有一个古老而神圣的传统：如果你收到RTFM（Read The Fucking Manual）的回应，回答者认为你应该去读他妈的手册。当然，基本上他是对的，你应该去读一读。

RTFM 有一个年轻的亲戚。如果你收到STFW（Search The Fucking Web）的回应，回答者认为你应该到他妈的网上搜索。那人多半也是对的，去搜索一下吧。（更温和一点的说法是 Google 是你的朋友！）

在论坛，你也可能被要求去爬爬论坛的旧文。事实上，有人甚至可能热心地为你提供以前解决此问题的讨论串。但不要依赖这种关照，提问前应该先搜索一下旧文。

通常，用这两句之一回答你的人会给你一份包含你需要内容的手册或者一个网址，而且他们打这些字的时候也正在读着。这些答复意味着回答者认为：

• 你需要的信息非常容易获得；
• 你自己去搜索这些信息比灌给你，能让你学到更多。

你不应该因此不爽；依照黑客的标准，他已经表示了对你一定程度的关注，而没有对你的要求视而不见。你应该对他祖母般的慈祥表示感谢。

如果还是搞不懂

如果你看不懂回应，别立刻要求对方解释。像你以前试着自己解决问题时那样（利用手册，FAQ，网络，身边的高手），先试着去搞懂他的回应。如果你真的需要对方解释，记得表现出你已经从中学到了点什么。

比方说，如果我回答你：看来似乎是 zentry 卡住了；你应该先清除它。，然后，这是一个很糟的后续问题回应：zentry 是什么？ 好的问法应该是这样：哦~~~我看过说明了但是只有 -z 和 -p 两个参数中提到了 zentries，而且还都没有清楚的解释如何清除它。你是指这两个中的哪一个吗？还是我看漏了什么？

处理无礼的回应

很多黑客圈子中看似无礼的行为并不是存心冒犯。相反，它是直截了当，一针见血式的交流风格，这种风格更注重解决问题，而不是使人感觉舒服而却模模糊糊。

如果你觉得被冒犯了，试着平静地反应。如果有人真的做了出格的事，邮件列表、新闻群组或论坛中的前辈多半会招呼他。如果这没有发生而你却发火了，那么你发火对象的言语可能在黑客社区中看起来是正常的，而你将被视为有错的一方，这将伤害到你获取信息或帮助的机会。

另一方面，你偶尔真的会碰到无礼和无聊的言行。与上述相反，对真正的冒犯者狠狠地打击，用犀利的语言将其驳得体无完肤都是可以接受的。然而，在行事之前一定要非常非常的有根据。纠正无礼的言论与开始一场毫无意义的口水战仅一线之隔，黑客们自己莽撞地越线的情况并不鲜见。如果你是新手或外人，避开这种莽撞的机会并不高。如果你想得到的是信息而不是消磨时光，这时最好不要把手放在键盘上以免冒险。

（有些人断言很多黑客都有轻度的自闭症或亚斯伯格综合症，缺少用于润滑人类社会正常交往所需的神经。这既可能是真也可能是假的。如果你自己不是黑客，兴许你认为我们脑袋有问题还能帮助你应付我们的古怪行为。只管这么干好了，我们不在乎。我们喜欢我们现在这个样子，并且通常对病患标记都有站得住脚的怀疑。）

Jeff Bigler 的观察总结和这个相关也值得一读 (tact filters)。

在下一节，我们会谈到另一个问题，当你行为不当时所会受到的冒犯。

如何避免扮演失败者

在黑客社区的论坛中，你以本指南所描述的或类似的方式，可能会有那么几次搞砸了。而你会在公开场合中被告知你是如何搞砸的，也许攻击的言语中还会带点夹七夹八的颜色。

这种事发生以后，你能做的最糟糕的事莫过于哀嚎你的遭遇、宣称被言语攻击、要求道歉、高声尖叫、憋闷气、威胁诉诸法律、向其雇主报怨、不去关马桶盖等等。相反地，你该这么做：

熬过去，这很正常。事实上，它是有益健康且合理的。

社区的标准不会自行维持，它们是通过参与者积极而公开地执行来维持的。不要哭嚎所有的批评都应该通过私下的邮件传送，它不是这样运作的。当有人评论你的一个说法有误或者提出不同看法时，坚持声称受到个人攻击也毫无益处，这些都是失败者的态度。

也有其它的黑客论坛，受过高礼节要求的误导，禁止参与者张贴任何对别人帖子挑毛病的消息，并声称如果你不想帮助用户就闭嘴。 结果造成有想法的参与者纷纷离开，这么做只会使它们沦为毫无意义的唠叨与无用的技术论坛。

夸张的讲法是：你要的是“友善”（以上述方式）还是有用？两个里面挑一个。

记着：当黑客说你搞砸了，并且（无论多么刺耳）告诉你别再这样做时，他正在为关心你和他的社区而行动。对他而言，不理你并将你从他的生活中滤掉更简单。如果你无法做到感谢，至少要表现得有点尊严，别大声哀嚎，也别因为自己是个有戏剧性超级敏感的灵魂和自以为有资格的新来者，就指望别人像对待脆弱的洋娃娃那样对你。

有时候，即使你没有搞砸（或者只是在他的想像中你搞砸了），有些人也会无缘无故地攻击你本人。在这种情况下，抱怨倒是真的会把问题搞砸。

这些来找麻烦的人要么是毫无办法但自以为是专家的不中用家伙，要么就是测试你是否真会搞砸的心理专家。其它读者要么不理睬，要么用自己的方式对付他们。这些来找麻烦的人在给他们自己找麻烦，这点你不用操心。

也别让自己卷入口水战，最好不要理睬大多数的口水战 —— 当然，这是在你检验它们只是口水战，并且未指出你有搞砸的地方，同时也没有巧妙地将问题真正的答案藏于其后（这也是有可能的）。

不该问的问题

以下是几个经典蠢问题，以及黑客没回答时心中所想的：

问题：我能在哪找到 X 程序或 X 资源？

问题：我怎样用 X 做 Y？

问题：如何设定我的 shell 提示？

问题：我可以用 Bass-o-matic 文件转换工具将 AcmeCorp 文件转换为 TeX 格式吗？

问题：我的程序/设定/SQL 语句没有用

问题：我的 Windows 电脑有问题，你能帮我吗？

问题：我的程序不会动了，我认为系统工具 X 有问题

问题：我在安装 Linux（或者 X ）时有问题，你能帮我吗？

问题：我怎么才能破解 root 帐号/窃取 OP 特权/读别人的邮件呢？

为了方便 Dante Cloud 开源版及企业版用户交流，深入了解、掌握 Dante Cloud 使用相关技术栈，快速解决实际应用问题。自 2025年8月18日起，Dante Cloud 重新开放 技术交流群，欢迎所有 真心 交流技术朋友加入。

说明

• 如果您觉得以上要求过份或者对您有所冒犯，大可以划走就当没有看到过，更没有任何交流讨论的必要。
• 如果您赞同以上观点并且觉得并无任何不妥，欢迎您进群，任何技术相关内容均可以坦诚的交流。

加群

可以使用 QQ 扫描下面二维码进群。

| 序号 | 赞助人 | 赞助时间 | 序号 | 赞助人 | 赞助时间 | 序号 | 赞助人 | 赞助时间 |
| :--: | :

全新的 Nacos 3.2.1 版本，表结构发生了较大变化，该版本与之前版本不兼容。需要重新建库重新导入配置。

v3.2.0

全新的 Nacos 3.2.0 版本，表结构发生了较大变化，该版本与之前版本不兼容。需要重新建库重新导入配置。

v3.0.1

Nacos 自 3.X 版本起, 对 Nacos 控制台和 Nacos 本身进行了拆分和优化。

Nacos 自3.0开始新增Nacos控制台的网络访问端口 8080，不再与 Nacos 的主端口（server.port，默认8848）进行耦合，以提升Nacos的安全性。Nacos 控制台地址变更为 http://localhost:8080/index.html。

基于 Dante Cloud 4.0.X 版本的单体离线演示 Docker 已经发布。该版本使用最新的 herodotus-cloud-ui-vuetify 作为前端，具备除了微服务基础能力外的所有功能。

[一]环境准备

离线体验版本，主要以 Docker 形式进行部署，这会减少很多部署的繁琐性。

如果您想在 Windows 环境下安装运行 Docker 环境，具体安装和配置方式，参见：【本地 Docker 安装配置】

如果是要在 Linux 或者其它操作系统中安装 Docker，请自行百度。

[二]镜像地址

离线镜像提供 Docker Hub 和 Quay.IO 两个仓库地址。

• Docker Hub: herodotus/herodotus-cloud-preview
• Quay.IO: quay.io/herodotus-cloud/herodotus-cloud-preview

[三]系统启动

[1]Docker

镜像下载完成之后，你可以直接使用 Docker 命令进行启动。

docker run --name preview quay.io/herodotus-cloud/herodotus-cloud-preview:latest -p 8000:8000 -p 8847:8847

[2]Docker Compose

除了 Docker 命令外，也可以使用 Docker Compose 脚本启动。

services:
  preview:
    image: quay.io/herodotus-cloud/herodotus-cloud-preview:latest
    container_name: preview
    hostname: preview
    environment:
      HERODOTUS_USE_DISABLE_DEVTOOL: false
      HERODOTUS_GITEE_SOCIAL_REDIRECT_URI: http://localhost:8000/preview/social/oauth2/callback/GITEE
    ports:
      - 8000:8000
      - 8847:8847
    volumes:
      - D:\\local-cached\\docker-volumes\\herodotus-preview\\logs:/usr/local/herodotus/logs
      - D:\\local-cached\\docker-volumes\\herodotus-preview\\files:/usr/local/herodotus/files

[四]环境变量

离线演示 Docker 镜像，提供了部分环境变量，便于对系统内的一些信息进行修改。

| 变量名 | 是否可选 | 说明 |
|

还是维持个人的观点：

• 传统单体项目通过看界面对系统功能也许就可以了解个大概，毕竟就是 CRUD 和一些业务逻辑的堆叠。
• 对于微服务系统，核心价值体现是在后端。这种价值是需要通过了解代码和实际运用才能了解和体会到的。
• 期望通过前端界面就可以对一套复杂架构的系统了解个大概完全就是个悖论。假设这种情况可以成立，那么完全没有必要来看什么开源项目，只要打开您手机中任意的APP——淘宝、支付宝、微信、抖音的，看看其界面就可以直接了解国内顶级大厂的系统架构了。

原本是一直主张让用户自己动手搭建，自己亲身体验的。之所以所以在开源了4年才搭建了个演示系统，也是情非所愿无奈之举，毕竟真正喜欢自己动手研究技术的人越来越少，省事、便捷的“快餐”才受人喜欢。

重要

以下内容均截取自使用者对 Danta Cloud 使用感受的反馈

评价一

评价二

注：该位朋友本职工作为运维工作，逐步转向开发工作

评价三

评价四

评价五

评价六

注：该位朋友本对知名的同类产品做了深度对比

评价七

评价八

评价九

评价十

Java 中 Exception 是很重要的一个组成部分。Exception 也并不是洪水猛兽，在可预期的代码逻辑中合理的使用 Exception 可以增强代码的健壮性，包含丰富信息的以及合理的 Exception 可以帮助开发人员快速定位问题。

日常开发中，我们常见的异常类型主要有两种：编译时异常（Exception）和运行时异常（RuntimeException）。

• 编译时异常：Exception及其子类(除了RuntimeException)，在编译时期抛出的异常，在编译期间检查程序是否可能会出现问题。如果可能会有，则预先防范。这一类异常如果不加处理，通常会导致组件或者应用无法启动
• 运行时异常（Runtime exception） 是用 RuntimeException 类表示的，它描述的是程序设计错误。RuntimeException 的任何子类都无需在 throws 子句中进行声明，指的就是这些问题不需要提前被预防（本质上也可以的，只不过没必要），因为只有在真正运行的时候才能发现是否发生问题，一旦在运行期间发生了问题，则一般不会修正。这一类异常更多的用于“提示”和“提醒”

本文中所述的自定义错误代码，主要是面向于 RuntimeException，用于在程序运行期间将操作产生的异常，用更人性化的表述方式展现给使用方，以便更容易、更快捷地定位问题。就像下图所示，显示更人性化的信息比抛出一大堆让人不知所云的错误信息更好。

目前，经常提到的 Exception 大概分为以下三类：

1. 系统业务代码自定义的 Exception，可能是 RuntimeException 也可能是 Exception
2. 第三方模块代码抛出的 Exception，可能是 RuntimeException 也可能是 Exception
3. 第三方模块代码抛出的继承类型 Exception。即，抛出的是第三方模块自定义 Exception 的基类，实际 Exception 信息被包含在基类 Exception

正因为 Java Exception 体系的灵活性以及第三方组件的丰富，使得想要统一处理异常变得越发复杂，这也是自定义错误码系统是 Dante Cloud 重要功能的原因。

下面就来介绍如何在 Dante Cloud 统一的错误码体系中添加和处理各种组件、各种类型的错误。

[一]常规类型异常

这里所说的“常规类型异常”，可以是 Java 自带的、大多数组件都会使用的通用类型异常，例如：NullPointerException。也可以是第三方组件自定义的异常。

这一类异常通常是 Exception 及其子类(除了RuntimeException)，比较好处理。利用 Spring Boot 自身 @RestControllerAdvice 的机制，就可以进行拦截。

具体的添加方法如下：

[1]定义错误信息

在 core-definition 模块中，找到 ErrorCodes 常量定义接口。在其中定义具体的 Exception 错误描述。例如：

public interface ErrorCodes {

    /**
     * 200
     */
    OkFeedback OK = new OkFeedback("成功");
    /**
     * 204
     */
    NoContentFeedback NO_CONTENT = new NoContentFeedback("无内容");
    /**
     * 401.** 未经授权 Unauthorized 请求要求用户的身份认证
     */
    UnauthorizedFeedback UNAUTHORIZED = new UnauthorizedFeedback("未经授权");
    UnauthorizedFeedback ACCESS_DENIED = new UnauthorizedFeedback("您没有权限，拒绝访问");
    UnauthorizedFeedback ACCOUNT_DISABLED = new UnauthorizedFeedback("该账户已经被禁用");
    UnauthorizedFeedback ACCOUNT_ENDPOINT_LIMITED = new UnauthorizedFeedback("您已经使用其它终端登录,请先退出其它终端");
    UnauthorizedFeedback ACCOUNT_EXPIRED = new UnauthorizedFeedback("该账户已经过期");
    UnauthorizedFeedback ACCOUNT_LOCKED = new UnauthorizedFeedback("该账户已经被锁定");
    UnauthorizedFeedback BAD_CREDENTIALS = new UnauthorizedFeedback("用户名或密码错误");
    UnauthorizedFeedback CREDENTIALS_EXPIRED = new UnauthorizedFeedback("该账户密码凭证已过期");
    UnauthorizedFeedback INVALID_CLIENT = new UnauthorizedFeedback("客户端身份验证失败或数据库未初始化");
    UnauthorizedFeedback INVALID_TOKEN = new UnauthorizedFeedback("提供的访问令牌已过期、吊销、格式错误或无效");
    UnauthorizedFeedback INVALID_GRANT = new UnauthorizedFeedback("提供的授权授予或刷新令牌无效、已过期或已撤销");
    UnauthorizedFeedback UNAUTHORIZED_CLIENT = new UnauthorizedFeedback("客户端无权使用此方法请求授权码或访问令牌");
    UnauthorizedFeedback USERNAME_NOT_FOUND = new UnauthorizedFeedback("用户名或密码错误");
    UnauthorizedFeedback SESSION_EXPIRED = new UnauthorizedFeedback("Session 已过期，请刷新页面后再使用");
    UnauthorizedFeedback NOT_AUTHENTICATED = new UnauthorizedFeedback("请求的地址未通过身份认证");

    ......
}

[2]添加错误字典

定义完错误码后，在 core-foundation 模块中，找到 GlobalExceptionHandler 类。在其中将之前定义的错误码，添加至 EXCEPTION_DICTIONARY Map 中。

public class GlobalExceptionHandler {

    private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    private static final Map<String, Feedback> EXCEPTION_DICTIONARY = new HashMap<>();

    static {
        EXCEPTION_DICTIONARY.put("AccessDeniedException", ErrorCodes.ACCESS_DENIED);
        EXCEPTION_DICTIONARY.put("BadSqlGrammarException", ErrorCodes.BAD_SQL_GRAMMAR);
        EXCEPTION_DICTIONARY.put("BindException", ErrorCodes.METHOD_ARGUMENT_NOT_VALID);
        EXCEPTION_DICTIONARY.put("CookieTheftException", ErrorCodes.COOKIE_THEFT);
        EXCEPTION_DICTIONARY.put("DataIntegrityViolationException", ErrorCodes.DATA_INTEGRITY_VIOLATION);
        EXCEPTION_DICTIONARY.put("HttpMediaTypeNotAcceptableException", ErrorCodes.HTTP_MEDIA_TYPE_NOT_ACCEPTABLE);
        EXCEPTION_DICTIONARY.put("HttpMessageNotReadableException", ErrorCodes.HTTP_MESSAGE_NOT_READABLE_EXCEPTION);
        EXCEPTION_DICTIONARY.put("HttpRequestMethodNotSupportedException", ErrorCodes.HTTP_REQUEST_METHOD_NOT_SUPPORTED);
        EXCEPTION_DICTIONARY.put("IllegalArgumentException", ErrorCodes.ILLEGAL_ARGUMENT_EXCEPTION);
        EXCEPTION_DICTIONARY.put("InsufficientAuthenticationException", ErrorCodes.ACCESS_DENIED);
        EXCEPTION_DICTIONARY.put("InvalidCookieException", ErrorCodes.INVALID_COOKIE);
        EXCEPTION_DICTIONARY.put("IOException", ErrorCodes.IO_EXCEPTION);
        EXCEPTION_DICTIONARY.put("MethodArgumentNotValidException", ErrorCodes.METHOD_ARGUMENT_NOT_VALID);
        EXCEPTION_DICTIONARY.put("MissingServletRequestParameterException", ErrorCodes.MISSING_SERVLET_REQUEST_PARAMETER_EXCEPTION);
        EXCEPTION_DICTIONARY.put("NoResourceFoundException", ErrorCodes.NO_RESOURCE_FOUND_EXCEPTION);
        EXCEPTION_DICTIONARY.put("NullPointerException", ErrorCodes.NULL_POINTER_EXCEPTION);
        EXCEPTION_DICTIONARY.put("ProviderNotFoundException", ErrorCodes.PROVIDER_NOT_FOUND);
        EXCEPTION_DICTIONARY.put("RedisPipelineException", ErrorCodes.PIPELINE_INVALID_COMMANDS);
        EXCEPTION_DICTIONARY.put("TypeMismatchException", ErrorCodes.TYPE_MISMATCH_EXCEPTION);
        EXCEPTION_DICTIONARY.put("TransactionRollbackException", ErrorCodes.TRANSACTION_ROLLBACK);
    }

    ......
}

[3]添加错误配置器

完成以上步骤后，需要将新定义的错误描述，添加至统一的错误配置器中。这一步主要的目的是让具体的错误描述生效，并且在实现错误码的自动计算。

步骤一：新建转换器

在代码中新建一个 XXXErrorCodeMapperBuilderCustomizer 类，该类需要实现 ErrorCodeMapperBuilderCustomizer 接口。然后将新建的错误描述信息，添加到其中，如下所示：

public class AccessErrorCodeMapperBuilderCustomizer implements ErrorCodeMapperBuilderCustomizer, Ordered {

    @Override
    public void customize(ErrorCodeMapperBuilder builder) {
        builder.preconditionFailed(
                AccessErrorCodes.ACCESS_CONFIG_ERROR,
                AccessErrorCodes.ACCESS_HANDLER_NOT_FOUND,
                AccessErrorCodes.SMS_IDENTITY_VERIFICATION_FAILED,
                AccessErrorCodes.WXAPP_IDENTITY_VERIFICATION_FAILED,
                AccessErrorCodes.WXMPP_IDENTITY_VERIFICATION_FAILED,
                AccessErrorCodes.JUATAUTH_IDENTITY_VERIFICATION_FAILED,
                AccessErrorCodes.ACCESS_PRE_PROCESS_FAILED_EXCEPTION,
                AccessErrorCodes.ILLEGAL_ACCESS_ARGUMENT,
                AccessErrorCodes.ILLEGAL_ACCESS_SOURCE
        );
    }

    @Override
    public int getOrder() {
        return ErrorCodeMapperBuilderOrdered.ACCESS;
    }
}

步骤二：定义配置器Bean

XXXErrorCodeMapperBuilderCustomizer 类定义完成之后，将其定义为 Bean 以保证其在启动时，可以正确注入。示例代码如下：

@Configuration(proxyBeanMethods = false)
public class AssistantAccessConfiguration {

    private static final Logger log = LoggerFactory.getLogger(AssistantAccessConfiguration.class);

    @PostConstruct
    public void init() {
        log.debug("[Herodotus] |- Module [Assistant Access] Configure.");
    }

    .....

    @Bean
    public ErrorCodeMapperBuilderCustomizer accessErrorCodeMapperBuilderCustomizer() {
        AccessErrorCodeMapperBuilderCustomizer customizer = new AccessErrorCodeMapperBuilderCustomizer();
        log.debug("[Herodotus] |- Strategy [Access ErrorCodeMapper Builder Customizer] Auto Configure.");
        return customizer;
    }

    ......

}

[4]注意事项

随着使用的第三方组件越来越多，常规的 Exception 定义也会越来越多。一个开发人员也不可能在开发过程中遇到所有的 Exception 情况的，是无法穷举所有 Exception 类，并且生成一个全面的 EXCEPTION_DICTIONARY Map。

目前采取的方式是：随用随加。

如果在使用 Dante Cloud 开发或使用过程中，出现了 EXCEPTION_DICTIONARY Map 中没有的 Exception。那么，可以自己手动将其补充进入到错误码体系中。同时，在 Dante Cloud 中为了方便发现这些未被记录的错误，会在系统日志中打印相关的 Exception 信息，方便发现和记录。如下所示：

Result<String> result = Result.failure();
String exceptionName = ex.getClass().getSimpleName();
if (StringUtils.isNotEmpty(exceptionName) && EXCEPTION_DICTIONARY.containsKey(exceptionName)) {
    Feedback feedback = EXCEPTION_DICTIONARY.get(exceptionName);
    result = Result.failure(feedback, exceptionName);
} else {
    log.warn("[Herodotus] |- Can not find the exception name [{}] in dictionary, please do optimize ", exceptionName);
}

另外，第三方组件中定义的 Exception 虽然很多，但开发中因为会进行大量的保护性代码的编写，实际会遇到的或者说需要提醒的错误并不是特别多。把经常会出现的 Exception 记录下来，就足以满足大量使用场景的需要了。

[二]特殊类型异常

前面提到，为了解决常规类型异常的统一，Dante Cloud 定义了统一的 GlobalExceptionHandler 类来处理。这足以满足绝大多数使用需求。

除了 GlobalExceptionHandler 类以外，在 Dante Cloud 中还有定义了一个 SecurityGlobalExceptionHandler 类。SecurityGlobalExceptionHandler 类的使用方法以及用途与 GlobalExceptionHandler 完全相同。

[1]额外处理的原因

之所以额外定义了一个 SecurityGlobalExceptionHandler 类，是因为 SecurityGlobalExceptionHandler 类主要是用于 Spring Security 以及 Spring OAuth2 等特殊组件的 Exception 处理。处于以下几点考虑，才会采取这样的处理方式：

方便模块的解耦，减少不必要的依赖

Spring Security 是一个完整的生态，整体也比较重,SecurityGlobalExceptionHandler 就依赖于 Spring Security 的部分组件中的类。如果将 SecurityGlobalExceptionHandler 和 GlobalExceptionHandler 合并在一起，就意味着在不需要使用 Spring Security 的场景下，也需要依赖部分 Spring Security 的包。不仅没有什么意义，还增加了依赖间的耦合。

Spring Security 中 Exception 类型不简单

Spring Security 生态中，很多自定义 Exception 都是继承类型的。很多场景下，只会抛出统一的自定义父类型 Exception，具体的 Exception（自定义父类型 Exception 的子类）会被包裹在父 Exception 中，需要额外的解析才能拿到具体的错误。

另外，Spring Security 生态中，很多错误都有自成体系的错误码，例如：access_denied。这个与前面所说的常规类型异常不同。所以就需要不同的方式来定位和转换错误描述。

[2]添加方式

添加此类错误信息的方式和步骤，与前面添加常规类型异常的方式和步骤完全相同。

唯一不同的是，EXCEPTION_DICTIONARY Map 中 Key 的值不同，如下所示：

public class SecurityGlobalExceptionHandler {

    private static final Logger log = LoggerFactory.getLogger(SecurityGlobalExceptionHandler.class);

    private static final Map<String, Feedback> EXCEPTION_DICTIONARY = new HashMap<>();

    static {
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.ACCESS_DENIED, ErrorCodes.ACCESS_DENIED);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.INSUFFICIENT_SCOPE, ErrorCodes.INSUFFICIENT_SCOPE);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.INVALID_CLIENT, ErrorCodes.INVALID_CLIENT);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.INVALID_GRANT, ErrorCodes.INVALID_GRANT);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.INVALID_REDIRECT_URI, ErrorCodes.INVALID_REDIRECT_URI);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.INVALID_REQUEST, ErrorCodes.INVALID_REQUEST);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.INVALID_SCOPE, ErrorCodes.INVALID_SCOPE);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.INVALID_TOKEN, ErrorCodes.INVALID_TOKEN);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.SERVER_ERROR, ErrorCodes.SERVER_ERROR);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.TEMPORARILY_UNAVAILABLE, ErrorCodes.TEMPORARILY_UNAVAILABLE);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.UNAUTHORIZED_CLIENT, ErrorCodes.UNAUTHORIZED_CLIENT);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.UNSUPPORTED_GRANT_TYPE, ErrorCodes.UNSUPPORTED_GRANT_TYPE);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.UNSUPPORTED_RESPONSE_TYPE, ErrorCodes.UNSUPPORTED_RESPONSE_TYPE);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.UNSUPPORTED_TOKEN_TYPE, ErrorCodes.UNSUPPORTED_TOKEN_TYPE);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.ACCOUNT_EXPIRED_EXCEPTION, ErrorCodes.ACCOUNT_EXPIRED);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.BAD_CREDENTIALS_EXCEPTION, ErrorCodes.BAD_CREDENTIALS);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.CREDENTIALS_EXPIRED_EXCEPTION, ErrorCodes.CREDENTIALS_EXPIRED);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.DISABLED_EXCEPTION, ErrorCodes.ACCOUNT_DISABLED);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.LOCKED_EXCEPTION, ErrorCodes.ACCOUNT_LOCKED);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.ACCOUNT_ENDPOINT_LIMITED_EXCEPTION, ErrorCodes.ACCOUNT_ENDPOINT_LIMITED);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.USERNAME_NOT_FOUND_EXCEPTION, ErrorCodes.USERNAME_NOT_FOUND);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.SESSION_EXPIRED_EXCEPTION, ErrorCodes.SESSION_EXPIRED);
        EXCEPTION_DICTIONARY.put(OAuth2ErrorKeys.NOT_AUTHENTICATED, ErrorCodes.NOT_AUTHENTICATED);
    }

    ......
}

[三]自定义类型异常

自定义类型异常，是开发中最常见的异常类型。就是实际开发中，根据业务需要自定义的异常类型。

[1]定义错误信息

第一步还是定义错误信息，与前面“常规类型异常”中，定义错误信息的方式相同。

不同的是，自定义类型异常的错误信息，不需要像“常规类型异常”一样在 core-definition 模块中进行定义。在任意模块中，新建一个常量接口进行定义即可。例如：

public interface AccessErrorCodes {

    PreconditionFailedFeedback ACCESS_CONFIG_ERROR = new PreconditionFailedFeedback("Access 模块配置错误");
    PreconditionFailedFeedback ACCESS_HANDLER_NOT_FOUND = new PreconditionFailedFeedback("Access 模块接入处理器未找到错误");
    PreconditionFailedFeedback ACCESS_PRE_PROCESS_FAILED_EXCEPTION = new PreconditionFailedFeedback("接入预操作失败错误");

    PreconditionFailedFeedback SMS_IDENTITY_VERIFICATION_FAILED = new PreconditionFailedFeedback("手机短信验证码登录身份认证错误");
    PreconditionFailedFeedback WXAPP_IDENTITY_VERIFICATION_FAILED = new PreconditionFailedFeedback("微信小程序登录身份认证错误");
    PreconditionFailedFeedback WXMPP_IDENTITY_VERIFICATION_FAILED = new PreconditionFailedFeedback("微信公众号登录身份认证错误");
    PreconditionFailedFeedback JUATAUTH_IDENTITY_VERIFICATION_FAILED = new PreconditionFailedFeedback("JustAuth 第三方登录身份认证错误");

    PreconditionFailedFeedback ILLEGAL_ACCESS_ARGUMENT = new PreconditionFailedFeedback("社交登录参数错误");
    PreconditionFailedFeedback ILLEGAL_ACCESS_SOURCE = new PreconditionFailedFeedback("社交登录Source参数错误");
}

[2]编写自定义异常

添加自定义异常类型，第一步就是编写一个 Exception。这个 Exception 需要继承 Dante Cloud 中统一的 PlatformRuntimeException，如下所示:

public class AccessConfigErrorException extends PlatformRuntimeException {

    public AccessConfigErrorException() {
        super();
    }

    public AccessConfigErrorException(String message) {
        super(message);
    }

    public AccessConfigErrorException(String message, Throwable cause) {
        super(message, cause);
    }

    public AccessConfigErrorException(Throwable cause) {
        super(cause);
    }

    protected AccessConfigErrorException(String message, Throwable cause, boolean enableSuppression, boolean writableStackTrace) {
        super(message, cause, enableSuppression, writableStackTrace);
    }

    @Override
    public Feedback getFeedback() {
        return AccessErrorCodes.ACCESS_CONFIG_ERROR;
    }
}

[3]定义配置器Bean

最后一步，就像前面常规类型异常 和 特殊类型异常 一样，将自定义的错误描述信息，添加至指定的错误配置器就行。

前缀：herodotus.oauth2.authorization

token-format

• Type: Enum
• Values: OPAQUE 和 JWT
• Default: OPAQUE

Token 校验是采用远程方式还是本地方式。即 Token 类型是 Opaque Token 还是 JWT Token。

strict

• Type: Boolean
• Default: true

否使用严格模式。严格模式一定要求接口一定要有对应的权限，没有权限则会被拦截。非严格模式不要求接口一定要有权限，只要查询到当前请求上下文中包含已经通过的认证信息（即当前用户已经登录），那么就不会被拦截也可以访问。

[二]OAuth2 Jwk 配置

前缀：herodotus.oauth2.authorization.jwk

certificate

• Type: Enum
• Values: STANDARD 和 CUSTOM
• Default: CUSTOM

证书策略：Standard OAuth2 标准证书模式；custom 自定义证书模式。

• STANDARD 模式，并不使用真正的证书，由系统内代码动态生成 Jwk 信息。
• CUSTOM 模式，需要在 UAA 中配置放置自定义的 .jks 文件。

jks-key-store

• Type: String
• Default: classpath\*:certificate/herodotus-cloud.jks

jks证书文件路径

jks-key-password

• Type: String
• Default: Herodotus-Cloud

jks证书密码

jks-store-password

• Type: String
• Default: Herodotus-Cloud

jks证书密钥库密码

jks-key-alias

• Type: String
• Default: Herodotus-Cloud

jks证书别名

[三]静态权限配置

前缀：herodotus.oauth2.authorization.matcher

static-resources

• Type: List
• Default: 空

静态资源过滤。配置不需要鉴权的资源，例如：css、image、js 资源等。

permit-all

• Type: List
• Default: 空

配置不需要鉴权的接口。

has-authenticated

• Type: List
• Default: 空

只校验是否请求中包含Token，不校验Token中是否包含该权限的资源

为什么说前面的内容是一种“耐心”的测试？

因为如果你能坚持看到这里，说明你是有足够耐心的，至少是想真正想学习东西的人，不会放过任何有可能学习到东西机会，而不是一时兴起或者说来凑个热闹刷个热点。这样不管是作为作者编写技术文章，还是作为读者学习技术内容，才会变得有意义。

可能有些朋友会觉得作者有点矫情，那么不妨先来看几个示例：

示例一

想必熟悉 Dante Cloud 的朋友都会知道，在2023年4月，一网友在 OSCHINA 上不停抹黑 Dante Cloud，只要是Dante Cloud 发布的文章，就会在评论中说 Dante Cloud 没有全部开源。找他沟通几次，问他为什么这么说，其理由是找不到 cn.herodotus.engine相关的代码，所以坚持认为 Dante Cloud 没有完全开源只是一个壳。

那么我们现在假设假设，暂且排除其故意抹黑的因素，那么这里就有一个问题，是真的没有任何线索、途径可以找到 cn.herodotus.engine 相关的代码？各位不妨回想一下，自己是如何知道 Dante Cloud？又是如何知道 Dante Engine的？

示例二

经常关注 Dante Cloud 技术交流群信息的朋友，可能就会发现，现在交流群中的问题，很重复、很基础甚至很无聊。基本上都是：“系统登录的用户名密码是什么？”，“为什么提示客户端验证错误？”，“哪位大神给一份 mysql 的数据脚本”，之类的在文档中均已写明了的内容。

现实问题

举这两个比较典型的示例，目的不是为了指责谁、污蔑谁，而是希望从中发现、总结问题。而这个问题的本质在我看来就是 —— “没耐心”

这不是为了抬高我自己，而是这就是我们这个行业的本质：“发现问题、解决问题”，引用 Dromara 社区 Cloud Eon 作者的话“最好的程序一开始只是作者对自己每天遭遇问题的个人解决方案，程序流传开来则是因为作者遇到问题成了一大类用户的典型问题”。而这些事情全部是以“耐心”为基础的。

当然，这个问题其实是可以完全理解的，现在社会一切事物节奏非常快，一切都以“快”为准绳。快餐、快递、被拆分成碎片化的信息等等。微博只可以写 140 个字，为了刷更多内容，可能随便扫两眼也许连 140 个字都没有看全，抓住几个关键字就对某个事件下定论；短视频，一分钟可以刷多少个，也不会去关心前因后果、深挖原因；影视剧多倍速观看，由于短视频的出现更方便，5分钟看一部电影。这就导致很多人希望个人的成长，特别是技术方面的成长也要快，最好是买几个视频、买几套文档看看，然后就可以达到 PX 的级别，独当一面，赚大钱享有无限荣光。

真的可以这样吗？

• 没有耐心，很多东西即使摆在眼前，可能都看不到 （上面的示例一就非常典型）。这还只是技术相关知识点而已，如果换成是可以改变人生的机会呢。
• 没有耐心，即使有人认认真真、详详细细的把你要了解学习的东西告诉你了，可能也只会明白其中极小的一部分 ，甚至听没听进去都得另说。
• 没有耐心，别说看书了，可能连完整的看完一篇文档都做不到，那还谈什么提升？ 前面示例二，就是这一类问题的典型。自以为自己一目十行的看过就明白，殊不知关键的信息和操作都给漏掉了。
• 耐心对于学习技术来是基本素质，甚至这都不是有钱就能解决的问题，而是需要自己真真切切的投入的 。（别在这儿较真啊，说老子有钱随便找人干。这里说的问题是提升自身的技术水平。况且你真那么有钱，TM 来这看什么文档啊？）
• 凭什么别人要深挖细作、苦苦钻研几年甚至十几年才有现在的水平和威望，你看几个视频、买几个文档就可以做到和别人一样？ 就好比，别人都要寒窗苦读十年才考上的大学，你找个老师讲讲，培训个两三个月就能考上大学？当然不说这种人没有，有这样的天才少年，但这是极其少数的。换个角度，如果真的是天才，也没有必要来看这些文档了。是不是？

单独开辟 关于“耐心” 这一章节，核心目的并不是为了说教。而是希望以这种方式，与广大读者做一个交流。因为个人觉得多少能够认可上面观点的朋友，才是真正想要学习技术提升自己的。只有存在理念相同的朋友，作者也才有坚持写下去的必要。毕竟，“人对了，任何事情至少成功一半”，“志同才能道合，道不同不相为谋”

另外，逆向思维一下，如果周围大多数人都没有耐心，学习技术都不踏实。而你则是耐耐心心、踏踏实实地成长，这会不会是另外一种“捷径”？

······

阅读

OAuth2 协议设计的初衷，并不是为了解决“用户”系统授权问题的，主要是为了解决“应用”（系统和系统之间，组件和系统之间）的授权问题。具体的可以阅读高级文章：【OAuth 2 中的 Scope 与 Role 深度解析】。

为了让 OAuth2 协议的适用性更强，可以支持更多应用场景，特别是目前流行的前后端分离的、微服务系统，将 OAuth2 和其它权限模型进行整合，例如：RBAC。所以，从某些角度讲基于“用户”的授权是开发者们“强加”在 OAuth2 中的。当然，OAuth2 协议也认识到了这个不足，所以才会有 OIDC 协议的产生。

即使有了 OIDC 的支持，甚至将 OAuth2 协议与其他权限模型进行了融合，由于 OAuth2 协议自身的局限，能否真正的理解以及灵活运用也是一项需要长时间投入的事情。

[一]融合 OAuth2 和 RBAC 模型的权限体系

Dante Cloud 在权限模型的设计中也选择了大家较为熟知和易用的 RBAC 模型。同时为了解决前面提到的问题，在融合 OAuth2 和 RBAC 方面也做了加大的努力。下图是 Dante Cloud 权限体系的 ER 图：

[1]权限体系设计

用户权限采用 RBAC 模型，所以主体设计与标准的 RBAC 基本一致。该部分的 ER 图如下所示：

标准的 RBAC 模型，正常情况包含：用户、角色和 权限 三个组成要素。因为微服务系统主要是面向 REST 接口，所以在此基础之上使用 RBAC 模型，那么对应的三要素就为用户、角色和 接口。这里的 接口 就是 RBAC 中的 权限。

之所以说 Dante Cloud 与标准的 RBAC 基本一致，意味着还是有一定的改造。在 用户、角色 和 权限三要素的基础之上又增加了一层 属性，其中：

• 用户：对应数据表 sys_user
• 角色：对应数据表 sys_role
• 权限：对应数据表 sys_permission
• 属性：对应数据表 sys_attribute

其中，权限 即真正使用的 RBAC 权限。这个权限就是最终放入到 Token 中，用于接口鉴权的权限。

[2]为什么要这么设计？

在早期的 Dante Cloud 中就是使用 REST 接口作为 RBAC 中的权限，即：为用户、角色和 接口。但是通过长时间的实践，发现这种方式并不适合，主要原因是：

• JWT Token 过长：直接使用 REST 接口作为权限，权限数据是需要放入到 Token 中，因为字符过多会导致生成 JWT Token 过长。权限数据越多，Token 字符串越长。
• 权限配置繁琐：随着业务系统的功能越多，接口也会越多。接口多了非常不利于权限的管理和控制。
• 功能开发混乱：微服务是以REST 接口为基础，但是前端却是以功能为基础。前端一个按钮操作可能就涉及多个接口。

所以，增加了一层权限设计，这样做可以带来以下好处：

• 配置权限更加简洁：只要配置指定权限即可，无需配置过多的接口。
• 实现接口权限的聚合：多个接口对应一个权限。一个权限可以对应一个功能或者其它细粒度的权限设计
• 方便后续扩展：REST 接口只是权限的一种，可能在你的系统中还会涉及其它权限元素。那么这些内容可以统一扩展至权限数据上。

[3]特殊处理

除了 sys_user、sys_role、sys_permission 和 sys_attribute 四个 RBAC 核心表之外，在数据表中还有一个特殊的数据表 sys_interface。sys_interface 表中的数据与 sys_attribute 基本一致，只是多了特殊的配置而已。

主要的逻辑为：

• 各个服务中的 REST 接口，在服务启动时会汇总至 sys_interface 表中
• 全部服务启动完成之后，会将有变化的数据同步至 sys_attribute 表中

之所以这样设计，是为了平衡 JPA 自身的机制局限与性能损耗。

JPA 的保存机制是：如果保存实体没有 ID 则进行 insert 做操作，这是会自动分配 ID；如果保存实体有 ID 则进行 update 操作，这里的更新是会更新全部字段，你可以把这个过程的结果效果“想象”成是先 delete 后 insert。注意：并不是真的做了这样的操作。当然，JPA 提供了指定更新字段的机制，但是这样会进一步损耗性能。

了解了这个机制我们看现在的设计。

现在的设计是以服务、接口映射等信息组成ID，在服务启动时对当前服务所有的接口进行扫描和拼装，然后汇总到 sys_interface。初次部署时这些数据是以 insert 方式保存至数据库。服务再次启动时，就会进行 update 操作。按照前面的逻辑，在 update 时所有的数据都会被更新。在这种情况下，如果在 sys_interface 表中增加了额外的字段，不管设置了什么值，update 时就会被更改为初始值。

为了解决这个问题，增加了 sys_attribute 表的设计。sys_attribute 表中的字段与 sys_interface 表中的字段大体一致，业务需求的额外数据均在 sys_attribute 表中涉及。每次服务启动完成，会对比 sys_interface 表中比 sys_attribute 表中多出的新增数据，然后将新增数据同步至 sys_attribute 表中，这样就仅做 insert 操作，不会影响 sys_attribute 表中额外的业务字段。

[4]界面操作

[二]前端界面权限

前端界面控制的权限，并没有像传统单体系统一样，将其直接与 RBAC 融合。而是利用 RBAC 中的角色，单独额外提取一套类似于 RBAC 的结构进行处理，该部分的 ER 图如下所示：

这样设计就意味着系统存在两套权限。一套负责后端接口权限，一套负责前端页面权限。设计思路，参见下面：【[七]设计思路总结】

[三]独有设计的动态接口鉴权

基于 Spring Security 的微服务架构，具体接口的鉴权是在接口所在的服务自身完成。

大多数使用 Spring Security 组件的系统，都会采用注解 @PreAuthorize 的方式，将权限数据写死。如果要修改权限或者存在权限变更，就需要通过修改代码来完成。Dante Cloud 设计了独有的动态权限体系，通过界面操作即可动态修改权限。无需修改代码或者重启服务。具体操作演示如下所示：

[四]静态配置接口鉴权

有些情况下对于一些不会经常变化的接口或者需要临时进行验证的一些接口，启动服务配置动态鉴权可能略显繁琐。系统也提供了另外的一种鉴权管理方式：静态配置接口鉴权。方便开发调试或者统一管控需求。

Dante Cloud 在几个方面提供静态配置接口鉴权支持：1、网关统一管控；2、服务静态鉴权；3、统一开放配置

[1]网关统一管控

网关，是微服务系统的安全门户，是系统安全的重要保障。对于网关服务后端的所有服务，提供“宏观性”的管理保障。对于整个系统管控以外的接口，通过网关服务就会拦截，不会进入到后续服务中，以保障整体的安全性。

在 Dante Cloud 中，网关服务仅做简单的鉴权处理：

1. 包含 Token 的接口访问，允许进入到后端服务进行二次鉴权。
2. 网关服务配置的静态权限，即使没有 Token 也允许进入到后端。（例如：系统中会存在一些特殊的开放性接口，这些接口一般不需要用户登录即可使用，这种情况下网关就需要放行）
3. 对于既不包含 Token 也不在静态鉴权配置中的接口，网关服务即直接拦截返回。这样也避免了后端无畏的性能损耗。

在 Gateway 的配置文件中即可以直接修改网关的静态权限配置：

herodotus:
  gateway:
    white-list:
      - "/oauth2/token"
      - "/oauth2/authorize"
      - "/v3/api-docs/**"
      - "/openapi*"
      - "/open/**"

[2]服务静态鉴权

服务静态鉴权是一种便捷的配置权限的方式，大多情况下是为了开发和调试方便。例如：正在开发一个接口，又不想进行繁琐的权限配置，那么就可以将其配置成静态权限。当然，这里所说的方便开发和调试，仅仅是一种建议，你完全可以结合自己的使用应用，将静态权限应用于更多场景。

服务静态权限也是通过服务的配置文件进行配置，示例配置如下：

herodotus:
  oauth2:
    authorization:
      matcher:
        permit-all:
          - /security/social/binding/list

更多的配置，可以参见：【资源服务属性配置】

[3]Ant 风格权限支持

在 Dante Cloud 中，所有静态权限均支持 Ant 风格路径模式。

Ant 风格就是一种路径匹配表达式。主要用来对 uri 的匹配。其实跟正则表达式作用是一样的，只不过正则表达式适用面更加宽泛，Ant 仅仅用于路径匹配。

Ant 风格的路径模式的基本通配符

• *：匹配零个或多个字符。
• **：匹配路径中的零个或多个目录，可以跨多级目录。

通配符的用法及示例

• /user/*：匹配 /user/name、/user/game、/user/123 等路径。
• /user/**：匹配 /user/name、/user/game、/user/123、/user/files/filename 等路径。

Ant 风格路径模式权限配置

Dante Cloud 中使用 Ant 风格路径模式配置权限示例如下：

herodotus:
  oauth2:
    authorization:
      matcher:
        permit-all:
          - /security/**

[五]动态权限和静态权限去重混合鉴权

在 Dante Cloud 中，动态权限和静态权限并不是各自独立的，而是互相融合的。

[1]权限去重

如果服务中配置了静态权限，并且该静态权限是 Ant 路径风格的权限。或者动态权限中，REST 接口也是 Ant 路径风格。那么服务在做接口到权限的转换过程中会进行权限重叠分析，将可覆盖的权限进行剔除，而选用覆盖范围最高的权限作为鉴权元数据。

具体逻辑可以参考以下示例：

在服务A中，存在两个接口：一个接口 a 为 GET - /security/permission/{id}, 另一个接口 b 为 GET - /security/permission/list。

因为在 Ant 风格下，a 可以涵盖 b，所以经过系统分析之后，会以 a 作为鉴权元数据同时忽略 b。

[2]权限优先

Dante Cloud 鉴权列表分析的主要逻辑为：

• 首先将动态权限和静态权限中，Ant 路径风格权限进行汇总
• 然后分析所有的非 Ant 路径风格权限。如果某个权限可以与 Ant 路径风格权限匹配，那么会将该权限从权限列表中剔除，不再参加鉴权校验。

所以，根据该逻辑设计 Ant路径风格权限的优先级 > 非Ant路径风格权限的优先级。

[六]OAuth2 Scope 接口鉴权

在使用 OAuth2 时，经常让人比较疑惑的知识点就是 Scope。OAuth2 默认的权限就是 Scope，而不是我们熟悉的接口（REST API）。

在使用 OAuth2 时，我们可以通过设计实现，修改 OAuth2 所使用的权限体系，比如和 RBAC 权限体系结合，让其不再局限于使用 Scope。但是由于 RBAC 权限体系是面对“用户”的，所以与 OAuth2 结合以后，只能对授权码模式（Authorization Code Grant）、密码模式（Resource Owner Password Credentials Grant）以及其它自定义的、涉及需要“用户”参与的授权模式起效。

想要深入了解，可以阅读【OAuth2中Scope与Role】。

对于像客户端凭证模式（Client Credentials Grant）这种，完全没有“用户”参与的授权模式，权限体系还必须使用 Scope。这就导致：

1. 如果我们开发涉及 REST 接口的、使用客户端凭证模式的应用，使用 Scope 是无法保护接口安全的。
2. 在 Spring Authorization Server 的标准实现中，Scope 权限的验证也仅仅是字符串的比较，达不到安全需求。

因此，Dante Cloud 专门对 Spring Authorization Server 进行了扩展，支持将 Scope 权限与接口进行绑定。配置好 Scope 权限之后，就可以直接对请求的接口进行权限校验。相关 ER 图如下图所示：

Dante Cloud 对客户端凭证模式进行了扩展，实现了通过分配 Scope 权限就可以对 REST 接口进行访问控制的能力。验证的方式如下：

1. 以接口 /security/user 为例，先请求一下这个接口，可以看到系统返回没有访问权限的提示，如下图所示

2. 我们为这个接口配置一个客户端凭证授权模式，同时指定其授权范围 Scope 为 read-user-by-page

3. 再次请求接口 /security/user，系统返回了接口响应数据

[七]设计思路总结

熟悉传统单体系统设计和开发的朋友，看到前面对本系统权限体系设计，可能会感觉很疑惑，甚至觉得与以往的认知格格不入。

还是本人常说的，单体架构和微服务架构不是简简单单的将一个系统拆分为多个服务，看似两者差不多实则在开发方法和设计思路方面有较大差别。使用微服务之前还是建议学习相关的知识，先改变以往开发的认知和习惯。否则只是简单的将单体应用中内容往微服务中生搬硬套，只会适得其反。

列举一下单体架构和微服务架构的主要差别，方便大家更好的理解以上的内容。

[1]核心元素和存放位置不同

单体架构的核心元素

单体架构的核心元素是 Session。Session 由后端服务生成，并且存放于服务端内存中，可以直接通过代码读取和设置。

Session 本质是为了解决 Web 应用的无状态性，所以传统单体项目用了 Session 可以说就是“有状态”的。所以传统单体系统所有的权限或者用户标识等信息均存放于后端 Session，变更权限、读取权限也相对方便，也可以“实时”改变 Session 中数据的状态。

微服务架构架构的核心元素

微服务架构（前后端分离）的核心元素是 Token。Token 由后端签发之后，是存放于各种类型的“前端”中。Token 是无状态的，所以用户相关的权限是要存储于 Token 中。

虽然，最终的鉴权还是在服务端，但是无法像 Session 一样“实时”修改 Token 中的内容。即使修改了后端存储的 Token，已经签发并且存放于前端的 Token 是无法修改的，只能通过重新生成 Token 的方式，比如说重新登录才能更新 Token 中的内容。

[2]权限面向的元素不同

单体架构的权限元素

传统单体架构核心的权限元素，通常是页面地址（如果使用的是 Spring 组件，那么这里所说的页面就是 @Controller 对应的代码）。比如说功能菜单对应的都是各个页面，而权限体系也是根据这些内容进行构建。当然，也可能会以“按钮”之类作为权限元素，但是终归是页面上的元素。

不管是页面上的元素作为权限还是实际的页面作为权限，都可以存储在后端的 Session 中随取随用。而且修改了权限数据后，页面也可以同步变化显示内容。前端是不容一获取到 Session 中存储的信息的。

微服务架构的权限元素

微服务架构核心的权限元素，对于后端来说就是 REST 接口（如果使用的是 Spring 组件，那么这里所说的页面就是 @RestController 对应的代码）。对于前端来说又是另外的权限元素。

虽然，可以将前端的权限元素存储在也存储在 Token 中，就像单体架构存储在 Session 一样。但始终会存在问题：

1. 前后端分离的应用，前端一个功能或者一个操作，可能对应后端多个接口。如果将两者融合在一起，权限逻辑会非常混乱
2. 如果将前端权限数据也存储在 Token 中，那么会导致 Token 越来越长，增大传输压力。而且要是自包含的 JWT Token，权限数据会和容易暴露。

[3]面对的前端种类不同

单体架构的前端种类

传统单体架构的前端，不管使用的是 JQuery 等组件还是原始的 JSP 等技术，最终面对的还是在同一个浏览器中运行的 HTML。

如果你曾经做过让单体应用支持移动端，不仅需要再重新创建一套 Token 体系，而且会发现用法与原来的权限体系格格不入。

微服务架构的前端种类

微服务架构所面对的前端，已经不仅仅只包含传统的 Web，还会包括原生移动端、小程序甚至桌面程序，前端的元素会是多种多样的。如果这么多前端的权限控制，都与后端接口融合在一起，那么将会是多么混乱的意见事情。

[4]应对变更的态度不同

单体架构应对变更

单体架构如果需求变化或者代码修改后，需要整体代码进行发布。一些企业发布管理流程和周期可能会非常长，也因此导致单体架构的设计偏重灵活性设计，就是在尽量不停机不发布的情况下，通过后端配置就可以产生更多变化以适应更多客户的需求。比如说：常说的数据权限就是由此而来。

微服务架构应对变更

微服务应对需求的变更的逻辑并不是“以不变应万变”，而是配合容器、DevOps、云技术可以实现快速的、大规模的发布和扩展。所以遇到变更，会通过修改代码，然后通过自动化手段，快速的发布部署。所以才会产生蓝绿部署、滚动部署、灰度发布、金丝雀发布等各种不同的发布策略。

一个很多朋友都会问到的问题：微服务架构是否支持数据权限。我的回答是：一方面不需要，如果可以实现快速发布，个人认为给接口增加个参数要远远优于配置一大堆所谓的数据权限；另一方面，实际的微服务会有很多个服务，可能一个服务会有多个实例，这种情况下做个数据权限去应对变化，岂不是自讨苦吃。

1. 修正 OpenFeign 调用过程中，UserAgent 头信息被修改，新增的(KHTML,like Gecko) 信息中，产生换行符，导致 illegalArgumentException 问题。
2. 修正平台 data-access-strategy: remote （OpenFeign 数据访问模式） 模式下，核心接口未授权问题。
3. 优化平台全局错误信息描述和后端响应的错误信息，让错误提示信息更加准确以及更加友好
4. 修正 OAuth2 Throwable Cause 信息转换成 自定义错误信息类型错误问题。

• 依赖包版本更新
  • aliyun-java-sdk-core 升级至 4.5.30
  • dysmsapi20170525 升级至 2.0.7
  • aliyun-sdk-oss 升级至 3.13.2
  • jpush-client 升级至 3.5.5
  • jiguang-common 升级至 1.1.12
  • bce-java-sdk 升级至 0.10.185

v2.5.7.10

1. Skywalking 版本升级至 8.8.0
2. 修正 docker-compose 配置错误问题
3. okhttps 升级至 3.3.1

v2.5.7.0

• 重大更新

  1. Spring Boot 升级至 2.5.7

• 其它更新

  1. 优化 Spring Cloud Gateway 响应体分段传输代码。修复在响应体特别大的情况下，Spring Cloud Gateway 读取响应体出错问题。
  2. 优化 Linux 和 Windows 两个版本的 docker-compose 脚本，修正脚本配置错误以及镜像引用错误。
  3. 优化部分后端响应的错误信息，让错误提示信息更加准确以及更加友好
  4. 优化前端登录页面部分错误信息提示展示方式。
  5. 修复前端登录页面密码输入错误后，再次发送请求不执行的问题。

v2.5.6.60

• 重大更新

  1. Spring Cloud Alibaba Sentinel 升级至 1.8.2
  2. 扩展改造 Spring Cloud Alibaba Sentinel，实现应用上报的 Metrics 持久化存储到 Influxdb 时序数据库中，支持反向将 Sentinel 流控配置信息以配置文件的形式持久化存储至 Nacos 中。时序数据存储基于 Influxdb 1.X 版本实现，默认使用原有内存方式存储数据，可通过配置参数动态开启或关闭 Influxdb 和 Nacos 存储机制。
  3. 全面使用扩展的 Sentinel Dashboard 进行限流、熔断、降级等管理。扩展的 Sentinel Dashboard 已封装为 Docker 镜像，并上传至 Docker Hub，可通过命令 docker pull herodotus/sentinel-dashboard:1.8.2(latest) 使用。Sentinel、Influxdb、Nacos 等相关内容均支持动态参数配置。
  4. 新增 TICK 开源监控产品套件 Telegraf、InfluxDB、Chronograf、Kapacitor 支持，新增 Influxdb 集成模块，补充平台时序数据存储、管理能力以及拓展更多维度的运行监控和数据展现能力。提供默认配置文件及 docker-compose 脚本。
  5. 新增 Linux 相关操作系统下使用的 docker-compose 脚本，同时提供 Linux 和 Windows 两种系统 docker-compose 脚本供选择使用。

• 其它更新

  1. 修正 Docker 打包参数错误，解决 Docker 打包过程中无法定位服务 jar 文件问题。
  2. 前端 Vuetify 版本升级至 2.6.0
  3. 前端工程升级大量依赖包版本，重新编译生成组件库

v2.5.6.50

• 重大更新
  1. 重构平台 Engine 代码，提取并新建 Cache、 Web、 Message 等代码模块。代码逻辑更内聚、模块职责更清晰。规避由于代码包以及模块间过度依赖，而导致模块使用过程中必须通过排除依赖或排除注入才能正常使用模块的问题。从根本上根除，由于过度依赖导致 spring-integration、spring-actuator 等组件在不受控的状态下启动或检查额外依赖组件问题。
  2. 增加 Sentinel 配置持久化机制。默认使用 Nacos 进行配置持久化存储与更新。
  3. 原 Management 服务名称变更为 Monitor，独立出 Management 服务作为平台各项配置统一管理服务。
  4. Spring Boot Admin 升级至 2.5.4 版本

v2.5.6.40

1. 前端工程支持 docker-compose 打包，进行容器化部署。集成 Nginx，支持 gzip 压缩，提升页面首次加载效率。
2. 解决 Vue 工程打包部署至 Nginx，favicon.ico 图标报 404 错误
3. 优化 Management 服务 Docker 打包逻辑，修复 Spring Boot Admin 混入 Skywalking 监控逻辑问题。
4. 修复 Spring Boot Admin 在正式环境下，依赖的 spring-boot-starter-actuator 主动连接 Redis 问题。
5. 优化 docker-compose 脚本，补充 BPMN 服务运行脚本。
6. 优化 Logstash 日志收集内容格式，修复 Logback 会创建多个 Logback 上下文导致冲突的问题
7. 补充 Nacos 2.0.3 数据库初始化脚本，删除低版本无用脚本。
8. docker-maven-plugin 升级至 0.38.0
9. Vuetify 升级至 2.5.14。

v2.5.6.30

1. 修复单体版代码依赖错误问题。单体版补充 Camunda 工作流功能。
2. 优化代码包结构，外部依赖应用提取为单独包结构，方便代码管理及维护
3. 增加对象存储(OSS)模块，开放 Minio 对象存储功能，支持注解@EnableXXX 条件开启和关闭。
4. 优化日志全链路跟踪信息，在 ELK 日志中心存储的结构。让日志聚合分析更加清晰准确。
5. 优化数据库初始化数据脚本。
6. Hutool 升级至 5.7.16
7. 前端工程升级依赖包版本，Vuetify 升级至 2.5.13，重新编译组件库。

v2.5.6.20

• 后端更新

  1. 修复 Gateway 网关服务，在生产环境下，关闭 SpringDoc 和 Swagger ，Bean 注入不正确问题。
  2. 优化 Gateway 网关服务发现服务动态接入服务 Swagger 文档监听器配置，通过配置动态关闭，在生产环境下不再开启。
  3. 单体版应用默认端口修改为 8847，与微服务版 Gateway 一致，方便前端接入
  4. 升级依赖包版本：
     • Redisson 升级至 3.16.4
     • Okhttps 升级至 3.3.0
     • weixin-java-miniapp 升级至 4.2.0

• 前端更新

  1. 优化组件库中，各个组件的配置以及导出逻辑，解决在生产模式下，组件库中组件显示不正确问题。
  2. 对生产模式下，Vue 工程打包进行深度性能优化。
  3. 对打包生成的各类资源进一步压缩，降低资源文件大小。
  4. 依赖包拆分变更为使用动态配置，编译时将所有依赖包都动态拆分为独立 js 文件，无须再根据分析结果手动进行拆分配置，极大地降低 Vue 默认打包文件的大小，解决首屏加载时间过长问题。
  5. 修复前端工程打包之后，部署至 Nginx 或 Express 页面空白或显示不正确问题。
  6. 解决 Vue 工程打包，index.html 文件丢失问题。
  7. 升级大量依赖包版本，重新编译库

v2.5.6.10

• 重大更新

  1. Spring Boot Admin 升级至 2.5.4
  2. Camunda Open Api 升级至 7.16.0

• 其它更新

  1. 修复 Camunda Open API 在 Swagger 中，无法正常显示问题。
  2. 删除本地静态文档，后续请使用在线文档进行查阅。
  3. 优化在线文档显示，增强在线文档可读性与易读性。
  4. 增加 Jenkins 持续集成组件部署配置
  5. 前端工程升级大量依赖包，重新编译生成组件库

v2.5.6.0

1. Spring Boot 版本升级至 2.5.7
2. 优化自定义多级缓存，对不同的 JPA 实体（数据表）设置不同的缓存时间，支持使用 Spring Boot Yml 配置，。支持 Duration 时间表达式，配置更灵活方便，提升自定义多级缓存的可控性。
3. 使用基于 Caffeine 和 Redis 的多级缓存，实现 Mybatis 自定义二级缓存，让 Mybatis 的数据缓存也可以支持分布式，同时降低数据缓存频繁访问 Redis 问题。

v2.5.5.70

• 重大更新

  1. 在现有架构基础之上，集成 Redisson 客户端。与 Spring Data Redis 同时使用，支持 Redisson 与 Lettuce 或 Jedis 共存。
  2. 重构核心包 eurynome-cloud-data 内主要 Configuration 代码。让各个 Configuration 职责更清晰,代码更内聚，更加便于理解,使用及扩展。
  3. 增加 WebSocket 核心代码模块，全面使用 STOMP 上层协议，支持 WebSocket 集群 Session 共享,信息广播及点对点发送,在线统计，可方便拓展断开重连,心跳机制。

• 其它更新

  1. 前端工程升级大量依赖包版本，重新编译生成组件库
  2. SpringDoc 升级至 1.5.12
  3. Hutool 升级至 5.7.15
  4. JustAuth 升级至 1.16.5

v2.5.5.60

1. 整合职责相近代码包，删除 eurynome-cloud-common 代码包，让各个代码包职责更明晰,逻辑更清楚。
2. 增加开发环境配置基础知识文档，帮助萌新少走弯路，可以更快地投入到系统的使用和代码研究学习的过程中来。
3. 依赖组件升级
   • Hutool 升级至 5.7.14
   • JustAuth 升级至 1.6.5
   • Camunda 升级至 7.16.0
   • okhttps 升级至 3.2.0
   • bce-java-sdk 升级至 0.10.179
   • jpush-client 升级至 3.5.3
4. Camunda 数据库脚本升级至 7.16.0

v2.5.5.50

1. 新增 Social Authentication 自定义授权模式方式，替代传统 Filter 过滤器方式，优化手机验证码,微信小程序,第三方认证的集成与 Token 的分派。代码更加简洁易于维护，解决了第三方认证游离于 OAuth 2 管控体系之外的问题。
2. 本着“高内聚,低耦合”的原则，调整代码，优化代码分包。提升代码分包的合理性，降低各代码包之间的耦合性。
3. 清除大量无用代码。
4. 前端代码升级大量依赖包版本，重新编译库。
5. 新增 Social Authentication 授权模式配置功能。
6. 回滚 compression-webpack-plugin 组件版本，解决高版本运行错误问题。
7. 补充在线文档 IDEA 使用常见问题章节。
8. 解决 MySQL 数据更新脚本数据类型不兼容问题

v2.5.5.40

1. 简化 OAuth2 资源服务器 ResourceServerConfigure 配置，代码更简洁规范。
2. 进一步融合 OAuth2 错误体系，解决 OAuth2 部分错误提示与系统自定义错误体系不一致,不融合的问题。
3. 解决包含路径参数的接口，可以跳过鉴权机制直接访问问题
4. 解决人员与用户 @OneToOne 映射，由 Jackson 反序列化实体导致 JPA 保存或修改失败问题。
5. 优化接口统一信息反馈类别，新增空数据信息结果反馈，让信息反馈内容更加友好
6. 补充常用正则表达式库
7. 优化人员管理,角色管理关键信息异步校验功能，解决人员管理，使用枚举作为数据类型类型导致的修改数据错误问题。
8. 新增为组织机构人员分配默认用户功能。
9. 新增系统默认角色配置功能。支持机构人员,手机验证码,微信小程序,QQ,微博,百度,微信开放平台,微信公众号,企业微信二维码,企业微信网页,钉钉,钉钉账号,阿里云,淘宝,支付宝,Teambition,华为,飞书,京东,抖音,今日头条,小米,人人,美团,饿了么,酷家乐,喜马拉雅,码云,开源中国,Github,Gitlab,Stackoverflow,Coding,谷歌,微软,脸书,领英,推特,亚马逊,Slack,Line,Okta,Pinterest 等多种途径或第三方登录默认角色的配置。

v2.5.5.30

1. Debezimu 升级至 1.7.0.Final
2. 优化统一结果返回实体封装，使用更加便捷。
3. 使用统一结果返回实体新接口，替换已有代码。
4. 优化接口数据前后端加密传输机制，全面支持使用 Spring @RequestParam 注解接口数据加解密。
5. 统一使用 @RequestParam 注解接口加解密方式，改进 OAuth 2 密码模式，用户名,密码参数加密，不再使用传统 Filter 方式，代码更加简洁规范清晰。
6. 重新调整 WebMvc 配置核心代码，依赖关系更合理，代码逻辑更清晰。
7. 优化完善前端用户管理相关功能。
8. 增加基于 VeeValidate 组件的服务端异步校验机制

v2.5.5.20

• 重大更新

  1. Spring Boot Admin 升级至 2.5.2
  2. 基于最新版 Axios 定义，所有 Delete 接口，修改为路径参数形式
  3. 混合 RSA(非对称) 和 AES(对称加密) 算法，基于自定义注解，设计接口数据前后端加密传输机制。
  4. 设计自定义数据传输 Session，规避 Vue Session 变化问题。基于自定义 Session，实现 AES KEY 动态生成,加密传输,一人一钥的安全机制，提高系统安全性。
  5. 实现 OAuth 2 密码模式，用户名,密码参数加密传输。

• 其它更新

  1. 修复 Spring Validation 错误信息不会抛出，循环引用问题。
  2. 前端 Utils 工具包，新增加密算法模块
  3. 基于最新版 Axios 定义，优化 Axios 请求通用代码
  4. 实现前端 node-rsa 包 RSA 算法，与后端 Hutool SecureUtil RSA 算法互相加,解密。

• 依赖包版本升级

  1. Guava 升级至 31.0.1-jre
  2. SpringDoc 升级至 1.5.11
  3. Mybatis Plus Generator 升级至 3.5.1
  4. 前端工程升级大量依赖包

v2.5.5.10

1. 解决 OAuth2 自带业务表通过 Spring Data JPA 自动创建，字段名变化为小写问题。
2. 完善前端 Camnuda 工作流编辑器组件功能。
3. 完善前端部分功能，解决已知问题。
4. 更新在线文档，补充前端工程详细介绍。

v2.5.5.0

• 重大更新

  1. Spring Boot 升级至 2.5.5
  2. Spring Cloud 升级至 2020.0.4
  3. 大幅改进系统数据库表和数据初始化方式，实现 OAuth2 业务表自动创建，取消使用脚本的创建方式，提升便捷性
  4. 新增人力资源管理相关功能，功能和模型设计实现与 Camunda 用户体系统一。便于用户体系数据的同步和管理。
  5. 基于 rollup,lerna 和 yarn workspaces，以 monorepo 方式重新构建前端工程。新版前端工程是以 Vue2,Typescript 开发的，组件库式的前端功能。代码更清晰,组件化和重用化程度更高。为升级至 Vue3 做前序铺垫。

• 其它更新

  1. 解决 Skywalking UI 连接 Skywalking OAP Server 出错问题。
  2. 修改防刷机制的默认配置
  3. 重新梳理错误体系，优化错误信息，错误提示更加友好。
  4. 解决单体版对 Basic 模式认证跨域拦截的问题
  5. 实现 OAuth2 Password 模式部分参数加密传输方式，提升系统安全性。
  6. 修复老版本前端工程已知问题。
  7. 在线文档同步更新。

• 依赖包版本升级

  1. Hutool 升级至 5.7.13
  2. okhttps 升级至 3.1.5
  3. weixin-java-miniapp 升级至 4.1.9.B
  4. JustAuth 升级至 1.16.4
  5. jasypt-spring-boot-starter 升级至 3.0.4
  6. mybatis-plus-boot-starter 升级至 3.4.3.4
  7. dysmsapi20170525 升级至 2.0.5

v2.5.4.140

1. 优化 Antisamy 通用代码，提升 Xss 分析西能，去除严格拦截导致的 JSON 解析错误。
2. 解决本地权限缓存并发写入冲突，抛出 com.esotericsoftware.kryo.KryoException: java.util.ConcurrentModificationException 问题。
3. 解决 OAuth Starter 引入 Upms Logic 重复导入权限数据问题。
4. 修改默认验证码字体配置
5. 去除无用依赖包
6. 新增 MySQL57 数据库切换配置。更新 Nacos 配置 SQL 脚本，增加最新导入包。
7. 新增 Camunda 官方脚本
8. 优化数据导入脚本

v2.5.4.130

1. 修复单体版 Knife4j 依赖错误问题
2. 修复单体版配置错误问题
3. 增加 Gitee 流程模版
4. 修复 OAuth2 自定义 confirm_access.html,error.html,login.html 页面，数据类型编译错误。
5. 优化自定义页面显示内容，增加 Exception StackTrace 输出
6. 修复 XssUtils 校验出错问题。
7. 优化 ResourceServer 安全配置
8. 修复 OAuth2 四种模式中授权码模式（Authorization Code）,隐式授权模式（Implicit Grant）模式出错问题。
9. 解决前端控制台出错问题
10. 更新在线文档，增加 OAuth2 四种模式验证说明

v2.5.4.120

1. 使用 Springdoc 全面替换 Springfox，配置更灵活,配置更多样
2. Swagger 文档注解全面升级为支持 OpenAPI
3. 使用 Springdoc 重构文档聚合功能，支持聚合查阅和服务独立查阅。Knife4j 同步升级至 3.0.3 版本。
4. Swagger 文档默认支持 OAuth2 Password,Authorization Code 两种认证流程
5. 整合 Camunda Engine Rest 与 Swagger，实现 Camunda API 接口文档查阅，支持聚合查阅。
6. 修复 Bpmn 服务默认启动 Tomcat 问题。
7. 升级前端依赖包版本
8. 更新 Nacos 配置文件及导入包
9. 更新在线文档

v2.5.4.110

1. 重新构建项目文档体系，使用纯静态页面，替代已有 Gitee Wiki 文档。优化文档结构，提升文档阅读体验。提供全文搜索，便于文档查阅。支持文档独立部署，方便使用者搭建独立的文档服务查阅。
2. 更换 Nacos 导入包，解决上一版本导入包导入重复问题
3. Update Readme

v2.5.4.100

1. 重新梳理所有 Nacos 配置，提取共性配置至统一配置文件，优化配置属性结构和归类，便于参数修改，降低维护复杂度
2. 重构数据库相关 Nacos 配置，优化 Maven,Nacos 多环境配置与数据库切换的联动性，让数据库切换所需修改的参数更少，切换更顺滑
3. 解决 eurynome-cloud-monitor 编译出现的 Failed to execute goal org.apache.maven.plugins:maven-resources-plugin:3.2.0:resources (default-resources) on 4. project XXXX: Input length = 1 -> [Help 1]错误
4. 解决 Redis 设置密码后，无法连接出现 NOAUTH Authentication required 错误
5. 增加 MySQL 数据库默认数据初始化脚本
6. 增加最新版 Nacos 配置导入包
7. 修复前端 UI 申请 APPKEY 页面错误
8. 修复前端 UI 切换至单体版后，连接错误问题。
9. 升级前端 UI 依赖包版本。
10. 同步更新相关文档，补充新建子模块,常见问题等部分文档。

v2.5.4.90

1. 使用 Mybatis Plus 全面替换已有 Mybatis，与 Spring Boot Data JPA 共存且支持同时使用。使用任何技术都可以无障碍的进行业务代码编写。
2. 整合 Mybatis Plus 和 Spring Boot Data JPA 更换数据库配置属性，一处修改即可以同时修改 Mybatis Plus 和 Spring Boot Data JPA 使用数据库类型。
3. 新增接口 XSS 脚本攻击过滤机制，同时支持请求参数和 JSON 请求体过滤。采用 Ebay XSS 过滤模型，进一步提升防控能力。
4. 新增 SQL 注入攻击防控机制。
5. 解决 eurynome-cloud-gateway 和 eurynome-cloud-monitor 服务启动调用 Kafka 问题。
6. 解决 CacheConfigException 错误问题，在错误体系中增加配置参数不合理提醒，让信息反馈更加友好。
7. 解决 Spring Boot Admin 不支持 Java 8 时间类型问题。
8. 解决 Spring Boot Admin 不显示 Git Properties 信息问题。
9. 解决修改 Redis 密码配置生效问题
10. 梳理 dependencies 依赖包，对已有依赖进行进行更合理的分类，更加便于依赖包的找寻和维护。
11. 升级依赖包版本
    • spring-boot-admin 升级至 2.5.1
    • git-commit-id-plugin 升级至 4.9.10
    • docker-maven-plugin 升级至 0.37.0
    • hutool 升级至 5.7.10
    • okhttps 升级至 3.1.4
    • JustAuth 升级至 1.16.3
    • aliyun-java-sdk-core 升级至 4.5.25
    • baiducloud-java-sdk 升级至 0.10.175
    • aliyun-java-sdk-oss 升级至 3.13.1
    • cn.jpush.api 升级至 3.5.2
12. 规范项目文档，增加系统部署,数据库切换等多部分内容
13. 增加 Nacos 配置导入包，在没有自动部署功能支持的情况下，也可以更加方便的导入配置。
14. 替换 UI SweetAlert 过期方法，解决弹出框不会关闭问题
15. 解决授权码模式（authorization code）验证码被拦截问题

v2.5.4.80

• 合并 eurynome-cloud-curd 包和 eurynome-cloud-rest 包，减少包数量，提升代码维护便捷度。
• 增加接口幂等处理机制，防止重复提交。增加接口防刷限制机制，防止接口恶意频繁刷新。
• 接口幂等和防刷机制，均支持全局配置控制，同时提供@Idempotent 和@AccessLimited 注解进行灵活的,个性化的配置。
• 接口幂等和防刷机制，缓存标记采用分布式多级缓存进行存储，将低单一访问 Redis 带来的访问压力，同时支持多实例数据多级缓存本地数据同步。
• 接口幂等和防刷机制，所涉及标记缓存时间配置全部统一支持 Duration 时间格式，简化配置参数，提升配置便捷度。同时，优化平台错误响应体系，返回更加友好的错误信息提示。
• 定义 Stamp 签章体系，采用统一体系，对 SMS 短信验证码,JustAuth State,环信 Token 以及接口幂等和防刷等需临时存储标记相关应用进行统一实现。同时，采用分布式多级缓存进行数据存储，降低单一访问 Redis 压力。

v2.5.4.65

• 优化 Skywalking 打包内容，直接使用 Skywalking 官方容器
• 补充 RequestMappingScanner 对应事件代码，解决单体版扫描 Rest API 接口后不会存储问题
• 优化数据库脚本以及数据库表结构和默认数据自动初始化机制。解决在第一次运行时，Spring Data JPA JDBC 初始化机制与 Hibernate 初始化机制冲突问题。
• 在 Gitee Wiki 中，增加数据库初始化说明文档
• 删除部分预留代码，减少暂时不必要的代码对使用者带来的误导。
• 前端 UI 中，增加部分配置，使用者可以通过注释部分配置，让前端 UI 快速支持单体版。

v2.5.4.60

• Spring Boot 版本升级至 2.5.4
• Skywalking 版本升级至 8.7.0
• 微服务日志输出至日志中心格式。
• 增加 Swagger 注入条件注解，优化日志中心相关配置采用统一常量控制
• 增加自定义 Property"助手"数据统一自动编译生成配置，无须额外设置，在 IDE 中编辑配置属性时可自动弹出提示
• 修复 Kafka 配置不生效问题。
• 解决单体版自动启动 Kafka 问题。
• 暂时关闭单体版 Swagger，规避 Swagger 会自动启动 Kafka 问题。

v2.5.4.55

• 整合代码，将 constant 包代码整合至 common 包中。删除 constant 包。
• 完善 Rest 接口校验机制，以及相关自定义错误码
• 统一 spring boot validation 错误信息，将其整合至平台统一响应实体 Result 中。无须在各个 Rest 接口中，添加 BindingResult 参数。

v2.5.4.50

• 优化服务本地权限存储逻辑，解决权限属性数据重复存储，不会替换问题。
• 重新梳理 Spring Security OAuth2 方法级表达式动态权限鉴权逻辑，摒弃无用的权限验证 Voter 逻辑，使用统一逻辑实现@PreAuthorize 注解权限的全面动态可配置化。统一平台接口- 白名单，IP 地址白名单，以及 Scope 绑定 URL 的管理。
• 重构 UserDetails 用户信息组织逻辑，使用 Spring Security 标准代码，替换自定义逻辑代码，降低代码冗余，与自研方法级动态权限完美融合。
• 优化平台权限从 Controller 扫描,汇总存储至服务器以及动态修改后最终回传同步至服务的整理逻辑以及事件流。完美支持单体式架构,UPMS 自身应用需求,分布式架构以及分布式各服- 务多实例等各种应用场景。
• 修复部分已知 BUG，将部分代码中日志由@Slf4j 改回传统日志编写方式，一方面提高编译效率，另一方面解决源代码包查看时 Idea 提醒代码不一致问题。
• 清理系统无用代码。
• 增加方法级动态权限演示动图，更新 Readme

v2.5.4.40

• 优化自定义多级缓存，实现可以统一设置 allowNullValues 值，并解决存储空值时卡死问题。
• 重新梳理,优化系统权限从 Controller 扫描,汇总存储至服务器以及动态修改后最终回传同步至服务的整理逻辑以及事件流。完美支持单体式架构,UPMS 自身应用需求,分布式架构以及- - 分布式各服务多实例等各种应用场景。
• 增加 Kafka 条件注入配置，将条件转换为@ConditionalOnXXX，方便管理和维护。避免单体版应用相关依赖过度依赖 Kafka 而导致的无法启动
• 修复部分已知 BUG，将部分代码中日志由@Slf4j 改回传统日志编写方式，一方面提高编译效率，另一方面解决源代码包查看时 Idea 提醒代码不一致问题。
• 去除传统 Kafka Producer 通用类，改为统一使用 Spring Cloud Bus

v2.5.4.30

• 重新调整 Property 配置，规范 Property 定义。修改相关配置
• 调整包，以及包相关依赖关系。让包之间的依赖更加合理
• 增加 Kafka 配置，增加@KafkaListener 动态控制，以避免在不需要的情况下 Kafka 的自动开启。
• 调整部分常理代码位置，常量代码基本调整完成
• 将原有自定义条件，转换为@ConditionalOnXXX 注解，让使用更加便捷
• 日志中心是否开启状态，改为@ConditionalOnLogCenterEnabled 注解

v2.5.4.20

• 本地权限缓存更换为 JetCache，为服务多实例的权限扫描和存储提供更好的支持
• 将数据访问策略从 Conditional 类，升级为 Conditional 注解，使用更加便捷
• 调整包依赖关系，新建 assistant,constant 包，删除 message 包。
• 逐步将平台中各类非独有常量移入 constant 包方便管理和修改
• 采用 Spring Boot Event 和 Spring Cloud Bus Event 机制重构接口收集逻辑。支持单体架构,UPMS,分布式多实例等不同场景接口扫描的特殊需求
• 优化 Docker Compose 配置，使用 Debezium Kafka 替换已有 kafka，以支持 Debezium 应用
• 删除无用代码

v2.5.4.10

• 全网首个实现 Spring Security 动态 URL 权限与注解表达式权限有机整合，并且可以动态配置的微服务框架。
• 全面支持方法级权限控制，Security OAuth2 permitAll 等方法权限以及@PreAuthorize 注解权限，均支持动态配置。目前支持以下权限的动态配置：
  · hasRole
  · hasAnyRole
  · hasAuthority
  · hasAnyAuthority
  · hasIpAddress
  · #oauth2.clientHasRole
  · #oauth2.clientHasAnyRole
  · #oauth2.hasScope
  · #oauth2.hasAnyScope
  · #oauth2.hasScopeMatching
  · #oauth2.hasAnyScopeMatching
  · #oauth2.denyOAuthClient
  · #oauth2.isOAuth
  · #oauth2.isUser
  · #oauth2.isClient
• 彻底解决使用 withObjectPostProcessor 方式，会覆盖外部匹配规则问题。
• 真正实现 Scope 权限与 URL 权限的关联与管控，拓展 OAuth2 默认只进行 Scope 简单对比的实现逻辑。
• 实现动态权限配置的多服务同步。
• 暂时去除 JetCache，全面使用自研支持 Hibernate 二级缓存的多级缓存。
• 修改配置文件配置
• 删除无用代码

v2.5.3.60

• Nacos 版本升级至 2.0.3
• Hutool 版本升级至 5.7.6
• 修改部分代码名称
• 修改配置文件配置参数

v2.5.3.50

• 将所有服务包括 UAA 的权限存储，改为本地和认证中心，多级分布式存储和验证。
• 增加策略模式，支持认证中心权限数据直连和远程消息两种存储方式动态切换。
• 改进自研多级缓存，解决 Hibernate 二级缓存进行数据缓存时产生的事务锁问题。
• 删除无用代码
• 为动态 Scope 权限做铺垫。
• 全面支持方法级权限控制。

v2.5.3.40

• Spring Boot 版本升级至 2.5.4
• 采用新的 Hash 算法，缩短权限标识；简化用户权限信息，以缩短平台生成 JWT Token 的长度
• git commit 插件由 pl.project13.maven » git-commit-id-plugin 改为 io.github.git-commit-id » git-commit-id-maven-plugin。
• git commit 插件升级至 5.0.0 版本

v2.5.3.30

• 重构用户中心用户人员体系，将平台用户,第三方社交登录用户,人事管理用户以及 Camunda 工作流用户体系无缝融合。
• 人事管理体系人员唯一化管理，同时支持企业,党组,团青等多种类型的机构类型，便于企业人事管理。
• 基于 Debezium 实现数据库变更数据捕获，实现人事管理信息与 Camunda 工作流用户实时同步。
• 树形结构通用代码实现逻辑与 Hutool Tree 一致，因此采用 Hutool Tree 全面替换已有的 Tree 代码。
• 删除不再使用的通用类代码。
• 修改说明文档

v2.5.3.10

• 自研基于 Caffeine 和 Redis 分布式两级缓存
• 完美支持 JPA Hibernate 二级缓存
• 完美支持各类查询数据缓存以及 JPA @ManyToMany, @ManyToOne 等关联查询。
• 实现基于 Caffeine 的 Hibernate 二级缓存，可与自研两级缓存快速切换，仅使用本地缓存。
• 极大的简化了原有自研的基于 JetCache 的缓存使用方式。
• 保留 JetCache，可根据实际使用需要使用。
• 已有服务接口相关代码，均已更新自研分布式两级缓存模式。

v2.5.2.40

• Redis Value 默认序列化工具修改为 Jackson2JsonRedisSerializer
• jetcache valueEncoder 和 valueDecoder 修改为 kryo
• 部分代码的日志改为传统方式，不再使用@Slf4j 注解
• 抽象实体共性属性，拓展基础实体，以支持 JPA 视图类的 ORM 映射。
• 重构基础 Service，将基础 Service 的读操作与其它操作分离，以支持“视图”相关 Service 的编写。
• 重构基础 Controller，将基础 Controller 的读操作与其它操作分离，以支持“视图”相关 Controller 的编写。
• 将 Hibernate Validator 替换为 spring-boot-starter-validation
• 删除 JPA 过期方法封装

v2.5.2.30

• Spring Boot 版本升级至 2.5.2
• Spring Boot Admin 版本升级至 2.4.2
• 升级其它相关依赖版本

v2.5.2.25

• Skywalking 升级至 8.6.0

v2.5.2.20

• Spring Boot 升级至 2.5.1
• Camunda 升级至 7.15.0
• 其它依赖包版本升级
• Swagger 回滚至 2.9.2，解决 Swagger 接口测试相关问题以及 Knife4 Authorize 不显示问题
• 结构性调整平台相关配置属性

v2.5.1.0

• Spring Boot 大版本升级至 2.5.0

v2.4.5.60

• 修改负载均衡不生效问题
• 调整包依赖关系
• 升级版本

v2.4.5.48

• 正式发布开源版本

• 主要更新
  • Spring Boot Admin 版本升级至 2.6.7
• 其它更新
  • Maven Invoker 版本升级至 3.2.0
  • Minio 版本升级至 8.4.1
  • Hutool 版本升级至 5.8.0
  • Bce-java-sdk 版本升级至 0.10.209
  • Alipay-sdk-java 版本升级至 4.23.11.ALL
  • Aliyun-sdk-oss 版本升级至 3.15.0

v2.6.6.20

• 主要更新
  • JetCache 版本升级至 2.6.3，感谢原作者修复 Spring Boot 2.6 下依赖循环问题。删除本项目原有临时解决 JetCache 依赖循环代码。
  • Spring Boot Admin 版本升级至 2.6.6
  • Skywalking Agent 版本升级至 8.10.0
• 其它更新
  • Antisamy 版本升级至 1.6.7
  • Logstash Logback Encoder 版本升级至 7.1.1
  • Minio 版本升级 8.3.8
  • Okhttps 版本升级至 3.5.0
  • WxJava 版本升级至 4.3.0
  • Bce-java-sdk 版本升级至 0.10.204
  • Qiniu-java-sdk 版本升级至 7.10.0
  • Alipay-sdk-java 版本升级至 4.22.86.ALL

v2.6.6.10

• 主要更新
  • Spring Boot Admin 版本升级至 2.6.5
  • Camunda 版本升级至 7.17.0，同时升级 Camunda Open API 文档，补充 Camunda 7.17.0 数据库脚本
• 其它更新
  • Antisamy 版本升级至 1.6.6.1
  • Springdoc 版本升级至 1.6.7
  • Okhttps 版本升级至 3.4.6
  • Qiniu-java-sdk 版本升级至 7.9.5
  • Alipay-sdk-java 版本升级至 4.22.81.ALL

v2.6.6.0

• 重要更新
  • Spring Boot 版本升级至 2.6.6。以规避（CVE-2022-22965）问题。当前环境不具备漏洞出现条件，只是进一步预防和规避。
• 其它更新
  • Okhttps 版本升级至 3.4.5
  • WxJava 版本升级至 4.2.9.B
  • Bce-java-sdk 版本升级至 0.10.202

v2.6.5.0

• 重要更新
  • Spring Boot 版本升级至 2.6.5
  • Spring Boot Admin 版本升级至 2.6.3
• 一般更新
  • 强制降低 Spring Integration 版本至 5.5.9，临时解决 Spring Integration 5.5.10 不兼容 Java 8 问题。已提交 ISSUE 至 Spring Integration 项目 #3761。确定在 Spring Integration 5.5.11 修复该问题
  • 修复 @Async 与 @Transactional 注解冲突，导致 @Transactional 失效问题。
  • 修复因@Transactional 失效，导致的权限数据存储死锁问题。
• 依赖更新
  • Redisson 版本升级至 3.17.0
  • Fastjson 版本升级至 1.2.80
  • Okhttps 版本升级至 3.4.4
  • Bce-java-sdk 版本升级至 0.10.201
  • Alipay-sdk-java 版本升级至 4.22.67.ALL
  • Logback 版本升级至 1.2.11

v2.6.4.20

1. Spring Cloud Gateway 安全问题修复 （CVE-2022-22947）
2. 依赖包版本升级
   • maven-embedder 版本升级至 3.8.5
   • maven-compat 版本升级至 3.8.5
   • WxJava 版本升级至 4.2.8.B
   • bce-java-sdk 版本升级至 0.10.200
   • qiniu-java-sdk 版本升级至 7.9.4
   • alipay-sdk-java 版本升级至 4.22.57.ALL
   • com.baidu.aip 版本升级至 4.16.7

v2.6.4.10

• 主要更新

  1. 增加 SpringDoc 配置，采用最新配置方式，解决 Swagger UI 认证界面无法输入 Client Secret 以及反复输入Client Id 和 Client Secret 问题。该问题需要更新 Nacos 配置才能生效。（注意：正式使用，建议单独为 Swagger 分配 Client Id 和 Client Secret，以确保安全性）
  2. 为提升 Swagger UI 显示内容的时效性，默认关闭 Swagger UI 页面缓存。
  3. 修改 Swagger UI 支持认证模式，默认支持 OAuth2 Password 模式和 Client Credentials 模式，关闭 Authorization Code 模式以及支持 PKCE 的 Authorization Code 模式

• 其它更新

  • Guava 版本升级至 31.1-jre
  • Hutool 版本升级至 5.17.22
  • WxJava 版本升级至 4.2.7.B
  • Mybatis-plus-generator 版本升级至 3.5.2
  • Bce-java-sdk 版本升级至 0.10.199
  • Alipay-sdk-java 版本升级至 4.22.49.ALL

v2.6.4.0

• 主要更新
  1. Spring Boot 版本升级至 2.6.4
  2. Spring Cloud Alibaba 版本升级至 2021.0.1.0
  3. 删除为升级 Spring Boot 2.6.X，而编写的临时解决 Sentinel 循环注入代码，全新使用 Spring Cloud Alibaba 标准代码。
• 其它更新
  • docker-maven-plugin 版本升级至 0.39.1
  • minio 版本升级至 8.3.7
  • log4j-api 版本升级至 2.17.2

v2.6.3.30

• 主要更新

  • Spring Cloud 版本升级至 2021.0.1

• 其它更新

  • Hutool 版本升级至 5.17.21
  • WxJava 版本升级至 4.2.6.B
  • alipay-sdk-java 版本升级至 4.22.37.ALL

• 额外说明

近期发布版本的频次降低，更新的内容也比较少。主要原因一方面是恰逢新春佳节，另一方面也是最主要的原因也是为后期的更新迭代做积极的准备和开发工作。

为什么现在积极准备后期的更新迭代，主要是因为后期的更新迭代对现有系统影响比较大：

Spring 官宣 spring-security-oauth 即将不再维护。虽然 spring-security-oauth2-autoconfigure 等组件包依旧可用，现目前 Spring 依赖的 spring-security-oauth2-autoconfigure 版本比较低，高版本所有的代码均已标记为过期。

所以近期一直在进行使用 Spring Authorization Server 替换现有 spring-security-oauth 的开发工作。包括 Herodotus Engine 工程的提取，以及 Dante Cloud v2.7.0.Beta2 的开发，均是为了降低已有系统代码间耦合，为 Spring Authorization Server 使用和升级铺路。

Spring Boot 3 下一代框架将基于 Java 17; Kafka 3.0 也已经宣布弃用 Java 8 的支持;Hibernate 宣布他们目前积极维护的分支都支持 Java17。Java 生态正在潜移默化进入一个新的时代，所以开始着手准备支持 Java 17 势在必行。

虽然说 Java 一直都是向下兼容的，但是微服务架构依赖的第三方开源包非常多，势必会存在一些依赖组件包在 Java 17 下使用不畅的情况，所以需要及时更新或替换。不断的升级更新，跟随业界的发展趋势，用新的技术来改善开发和使用。同时，规避处于长期不更新导致后期即使很小的更新都会牵一发而动全身的尴尬境地。

v2.6.3.20

• 重要更新

  • Skywalking 版本升级至 8.9.0
  • 升级 Antisamy xml 配置，强化 XSS 防控能力

• 其它更新

  • docker-maven-plugin 版本升级至 0.39.0
  • antisamy 版本升级至 1.6.5
  • springdoc 版本升级至 1.6.6
  • skywalking 版本升级至 8.9.0
  • minio 版本升级 8.3.6
  • bce-java-sdk 版本升级至 0.10.193
  • qiniu-java-sdk 版本升级至 7.9.3
  • alipay-sdk-java 版本升级至 4.22.32.ALL
  • jpush-client 版本升级至 3.6.1

v2.6.3.10

1. Spring Boot Admin 版本升级至 2.6.2
2. 修改 Dockerfile 配置，将 alpine 容器源修改为阿里源，提升打包 Docker 字体等资源下载速度
3. 修复服务打包成 Docker 镜像后，openjdk:8-jdk-alpine 无法找到字体，导致渲染图形验证码抛空问题。
4. 将 alpine 容器默认 UTC 时区，修改为 "GTM + 8" 时区
5. 前端工程 Vuetify 版本升级至 2.6.3。同步升级大量其它依赖包版本。
6. 后端工程依赖升级：
   • Redisson 版本升级至 3.16.8
   • Hutool 版本升级至 5.7.20
   • WxJava 版本升级至 4.2.5.B
   • mybatis-plus-boot-starter 版本升级至 3.5.1
   • dysmsapi20170525 版本升级至 2.0.9
   • bce-java-sdk 版本升级至 0.10.190
   • alipay-sdk-java 版本升级至 4.22.30.ALL
   • baidu-java-sdk 版本升级至 4.16.5
   • aliyun-sdk-oss 版本升级至 3.14.0

v2.6.3.0

• 重要更新

  1. Spring Boot 版本升级至 2.6.3
  2. Nacos 版本升级至 2.0.4

• 其它更新

  • okhttps 版本升级至 3.4.2
  • minio 升级 值 8.3.5

v2.6.2.90

1. Spring Boot Admin 升级至 2.6.1
2. 修复前端工程，因阿里库依赖包签名不正确，导致执行 yarn 编译命令以及 yarn 升级依赖命令，会抛出 Integrity check failed for "graceful-fs" (computed integrity doesn't match our records 错误问题。

v2.6.2.80

• 重要更新

1. Spring Boot Admin 升级至 2.6.0。
   • Spring Boot Admin 监控元数据包含 null 值会抛出 NullPointerException 的问题已解决。感谢 Dante Cloud 技术交流群群友【liviing{}{}】发现此问题，并提供解决方案。才得以提交 ISSUE 至 Spring Boot Admin 得到快速解决， ISSUE ID：#1925。
2. Sentinel 全面升级至 1.8.3
   • 解决使用 Spring Cloud Alibaba 2021.1 导致 Sentinel 无法升级问题。
   • 封装的 Sentinel Dashboard 同步升级至 1.8.3。最新打包 herodotus/sentinel-dashboard 镜像已上传至 Docker Hub
   • Docker Compose 脚本修改为使用最新 herodotus/sentinel-dashboard:1.8.3
3. 新增支付核心模块
   • 支付模块对阿里支付、微信支付核心支付 API 进行了封装，支持普通商户及 ISV 模式，使用更加便捷。
   • 商户信息可配置，支持多商户管理。默认使用配置文件进行商户信息配置，支持使用关系型数据库进行商户信息存储，也可灵活自定义其它类型的存储媒介。
   • 采用事件机制实现支付异步通知以及异步回调处理，规避多次异步通知问题。
   • 最大程度上降低支付模块与实际业务的耦合性，便于开发更加独立的、更易扩展的订单、支付等微服务。

• 其它更新
  1. 解决阿里支付 SDK 自身依赖包与 Antisamy 依赖冲突，导致系统接口无法正常调用问题。
  2. 解决行为验证码偶尔出现缓存数据无法序列化问题。
  3. 前端工程升级大量依赖包，重新编译组件库。
  4. 后端依赖包版本升级
     • Springdoc 版本升级至 1.6.4
     • Hutool 版本升级至 5.7.19
     • WxJava 版本升级至 4.2.4.B
     • mybatis-plus-boot-starter 版本升级至 3.5.0
     • aliyun-java-sdk-core 版本升级至 4.6.0
     • bce-java-sdk 版本升级至 0.10.188
     • qiniu-java-sdk 版本升级至 7.9.2
     • alipay-sdk-java 版本升级至 4.22.17.ALL
     • jpush-client 版本升级至 3.6.0
     • jiguang-common 版本升级至 1.2.0

v2.6.2.70

1. 升级 bcprov-jdk15on 版本，修复安全漏洞 CVE-2020-28052，解决 bcprov-jdk15on 在工程中存在多个版本重复的依赖包问题。
2. 优化平台新服务创建 Maven Archetype，解决 .gitignore 被过滤不会拷贝的问题。
3. 增加 Maven 管理代码包，可通过代码或界面操作实现新服务的创建

v2.6.2.60

1. 新增平台服务 Maven Archetype，方便新服务的构建和开发
2. 优化平台核心 Maven Dependences，去除无用依赖内容，让 pom.xml 内容更清晰
3. 升级 Debezimu 版本至 1.8，同步修改 docker-compose 脚本。
4. 删除原有验证码接口无用的权限设置代码
5. 删除 dante-cloud-influxdb 和 dante-cloud-oss 模块代码，减少额外代码对学习本系统带来的复杂度
6. 升级系统依赖包版本：
   • Springdoc 版本升级至 1.6.3
   • Hutool 版本升级至 5.7.18
   • Mybatis 版本升级至 3.5.9
   • Log4j 版本升级至 2.17.1

v2.6.2.50

1. Jetcache 版本升级至 2.6.2 （提了 Jetcache 2.6.1 版本 redis 缓存 key 中包含 null 的 ISSUE，作者快速响应并修复，感谢 Jetcache 作者）
2. 强制升级 Logback 版本至 1.2.10，以规避 Logback 安全漏洞 CVE-2021-42550
3. 回滚 Spring Boot Admin 版本至 2.5.4，以临时解决 Spring Boot Admin 2.5.5 版本在元数据包含 null 值的情况下会抛出 NullPointerException 的问题。已向 Spring Boot Admin 提出 ISSUE #1925，待修正后再升级
4. 重构 eurynome-cloud-captcha 包代码，将行为验证码与图形验证码以及 Hutool 验证码整合并统一，目前支持滑块拼图、文字点选、算数类型、中文类型、字母类型、GIF 类型，以及 Hutool 圆圈干扰、扭曲干扰、线段干扰等多种类型验证码。
5. 使用独立的、统一的接口进行验证码调用以及验证码的验证。通过修改接口即可动态变更验证码的显示和调用。
6. 通过 Spring Boot 配置，可以动态修改验证码的大小、内容、字体等多维度参数，让验证码的显示更具多样性和灵活性。
7. 重构 OAuth2 授权码模式登录页面代码，替换已有验证码，更换为新的统一验证码接口。不再使用已经不再维护的第三方开源验证码包。
8. 修正前端验证码组件，在重新设置滑块大小参数情况下，滑块显示位置错误并导致验证失败问题。
9. 调整部分代码日志级别，减少日志在 Debug 模式下不必要的日志输出
10. 依赖包升级：
    • Redisson 版本升级至 3.16.7
    • Springdoc 版本升级至 1.6.2
    • Fastjson 版本升级至 1.2.79

v2.6.2.40

• 重大更新
  • Spring Boot 版本升级至 2.6.2
  • lombok 版本升级至 1.18.22
  • docker-maven-plugin 版本升级至 0.38.1
• 其它更新
  • Jetcache 回滚至 2.6.0 版本，规避 Jetcache 2.6.1 版本在 redis 中生成缓存 key 中包含 null 的问题

v2.6.2.30

• 重大更新
  • Spring Boot Admin 版本升级至 2.5.5
• 其它更新
  • Apache Log4j2 版本升级至 2.17.0，解决第三个安全漏洞 CVE-2021-45105
  • 独立的 eurynome-cloud-upms-api 包，已经失去单独提取的意义，将其与 eurynome-cloud-upms-logic 包整合。
  • 新增认证成功后，登录信息日志记录。

v2.6.2.20

1. Apache Log4j2 版本升级至 2.16.0，彻底根除安全漏洞问题
2. 新增组合式、可配置化的图形验证码功能。独立出单独验证码模块，为后续更多的验证码集成奠定基础。
   主要特点：
   • 同时支持滑块拼图验证码和文字点选验证码。
   • 后端可通过配置，灵活定制和修改验证码细节；
   • 前端组件化封装，可通过参数动态指定所使用的验证码
   • 使用统一接口实现不同验证码的生成与验证。
   • 与平台自定义 Session 高度融合，整合幂等、防刷等管控机制，前后端数据加密传输，提升验证码使用安全性。
   • 验证码反馈信息，与平台统一错误体系有机结合，用户体验进一步提升。
3. 优化 Feign 请求信息传输，修正 UserAgent 信息被修改后未回置问题。
4. 前端工程升级大量依赖包，重新编译组件库代码。
5. 后端核心依赖包版本升级
   • Springdoc 版本升级至 1.6.1
   • Mybatis 版本升级至 3.5.8

v2.6.2.10

1. 修复 Apache Log4j2 的远程代码执行漏洞安全问题
2. 进一步优化调整核心代码模块依赖关系，降低模块间的耦合程度，减少部分核心模块被过度依赖的情况。
3. 升级依赖包版本
   • Logstash Logback Encoder 版本升级至 7.0.1
   • Hutool 版本升级至 5.7.17
   • aliyun-java-sdk-core 版本升级至 4.5.30
   • dysmsapi20170525 版本升级至 2.0.8
   • qiniu-java-sdk 版本升级至 7.9.0

v2.6.2.0

1. 重构平台基础核心代码，调整部分核心代码归属模块，让各个核心代码模块逻辑更加清晰、职责更加内聚。
2. 调整核心代码模块依赖关系，降低模块间的耦合程度，减少部分核心模块被过度依赖的情况。
3. 升级大量基础核心依赖包版本
   • Fastjson 版本升级至 1.2.78
   • JetCache 版本升级至 2.6.1
   • Redisson 版本升级至 3.16.6
   • SpringDoc 版本升级至 1.5.13
   • Minio 版本升级至 8.3.4
   • Okhttps 版本升级至 3.4.1
4. 前端工程升级使用依赖包版本，重新编译组件库。

v2.6.1.0

• 重大更新

  1. Spring Boot 版本升级至 2.6.1
  2. Spring Cloud 版本升级至 2021.0.0
  3. 新增 Sentinel 自动降级处理机制。

• 其它更新

  1. 解决 JetCache 2.6.0 在 Spring Boot 2.6.X 环境下，Bean 循环依赖问题。
  2. 解决 Spring Cloud Alibaba Sentinel 2021.1 在 Spring Boot 2.6.X 环境下，Bean 循环依赖问题。
  3. 解决 Spring Boot 2.6.X 环境下，由于代码方法变更，导致接口自动化扫描抛空错误问题。
  4. 解决 Sentinel 与 Feign 冲突问题。
  5. 解决 Spring Cloud OAuth2 由于无用代码的注入，导致的 Bean 循环依赖问题。
  6. 前端 Vuetify 版本升级至 2.6.1，升级相关依赖包版本，重新编译组件库

• 重要说明
  • Spring Boot 2.7.X 于 2023 年 11 月 24 日 停止维护，最后发布一次 Dante Cloud 2.7.X 版本以示纪念
• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.18
  • [升级] Spring Boot Admin 版本升级至 2.7.13
  • [升级] spring-security-oauth2-authorization-server 版本升级至 0.4.4
• 其它更新
  • [升级] 同步更新最新版本 Antisamy XSS 防护配置文件
• 依赖更新
  • [升级] antisamy 版本升级至 1.7.4
  • [升级] commons-io 版本升级至 2.15.0
  • [升级] guava 版本升级至 32.1.3-jre
  • [升级] redisson 版本升级至 3.24.3
  • [升级] minio 版本升级至 8.5.7
  • [升级] fastjson2 版本升级至 2.0.42
  • [升级] hutool 版本升级至 5.8.23
  • [升级] okhttps 版本升级至 4.0.2
  • [升级] wxjava 版本升级至 4.5.7.B
  • [升级] mybatis plus 版本升级至 3.5.4.1
  • [升级] mybatis 版本升级至 3.5.14
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.893
  • [升级] alipay-sdk-java 版本升级至 4.38.140.ALL
  • [升级] com.baidu.aip 版本升级至 4.16.17
  • [升级] aliyun-sdk-oss 版本升级至 3.17.2
  • [升级] xnio 版本升级至 3.8.12.Final
  • [升级] log4j 版本升级至 2.21.1
  • [升级] jackson 版本升级至 2.15.3

v2.7.16.Final

• 重要说明
  • 因 Spring Boot 2.7.X 和 3.0.X 将分别于 2023 年 11 月 18 日 和 2023 年 11 月 24 日 停止维护，考虑到技术发展趋势，决定停止 Dante Cloud 2.7.X 版本代码的维护，专注 3.1.X 维护及 3.2.X 开发。2.7.16.Final 版本是 Dante Cloud 2.7.X 系列最后一个版本，代码仍旧会保留，可在工程 2.7.X 分支中获取。
• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.16
  • [升级] Spring Boot Admin 版本升级至 2.7.11
• 依赖更新
  • [升级] redisson 版本升级至 3.23.5
  • [升级] fastjson2 版本升级至 2.0.40
  • [升级] hutool 版本升级至 5.8.22
  • [升级] wxjava 版本升级至 4.5.5.B
  • [升级] aliyun-java-sdk-core 版本升级至 4.6.4
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.853
  • [升级] alipay-sdk-java 版本升级至 4.38.85.ALL
  • [升级] snakeyaml 版本升级至 2.2
• 其它说明
  • 还没拥抱 JDK 17 么？JDK 21 都已经来到了！

v2.7.15.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.15
• 其它更新
  • [优化] 默认数据库名称进行变更，修改为与项目名称一致，方便记忆和使用
• 依赖更新
  • [升级] docker-maven-plugin 版本升级至 0.43.4
  • [升级] bcprov-jdk15to18 版本升级至 1.76
  • [升级] guava 版本升级至 32.1.2-jre
  • [升级] redisson 版本升级至 3.23.3
  • [升级] minio 版本升级至 8.5.5
  • [升级] fastjson2 版本升级至 2.0.39
  • [升级] hutool 版本升级至 5.8.21
  • [升级] wxjava 版本升级至 4.5.4.B
  • [升级] mybatis-plus 版本升级至 3.5.3.2
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.835
  • [升级] qiniu-java-sdk 版本升级至 7.14.0
  • [升级] alipay-sdk-java 版本升级至 4.38.61.ALL
  • [升级] aliyun-sdk-oss 版本升级至 3.17.1
  • [升级] snakeyaml 版本升级至 2.1

v2.7.14.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.14
• 其它更新
  • [优化] 删除 Gateway 服务中无用的 RedisRouteDefinitionRepository 类以及无用的依赖。避免使用该类进行无防护的业务功能开发，导致产生安全问题。
  • [修复] 修复前端 bpmn-designer 模块在新版 vite 环境下编译模块出错问题。
  • [修复] 修复前端在新版本 vite-plugin-dts 环境下编译模块出错问题
• 依赖更新
  • [升级] guava 版本升级至 32.1.1-jre
  • [升级] redisson 版本升级至 3.23.1
  • [升级] fastjson2 版本升级至 2.0.36
  • [升级] transmittable-thread-local 版本升级至 2.14.3
  • [升级] wxjava 版本升级至 4.5.2.B
  • [升级] dysmsapi20170525 版本升级至 2.0.24
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.800
  • [升级] alipay-sdk-java 版本升级至 4.38.10.ALL

v2.7.13.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.13
  • [升级] Spring Cloud 版本升级至 2021.0.8
  • [升级] Debezimu 版本升级至 2.3
• 依赖更新
  • [升级] guava 版本升级至 32.1.0-jre
  • [升级] bcprov-jdk15to18 版本升级至 1.75
  • [升级] minio 版本升级至 8.5.4
  • [升级] wxjava 版本升级至 4.5.1.B
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.787
  • [升级] alipay-sdk-java 版本升级至 4.35.171.ALL
  • [升级] aliyun-sdk-oss 版本升级至 3.17.0

v2.7.12.1

• [升级] spring-security-oauth2-authorization-server 版本升级至 0.4.3
• [升级] nacos 版本升级至 2.2.4
• [升级] hutool 版本升级至 5.8.20
• [升级] docker-maven-plugin 版本升级至 0.43.0
• [升级] commons-io 版本升级至 2.13.0
• [升级] guava 版本升级至 32.0.1-jre
• [升级] redisson 版本升级至 3.22.1
• [升级] logstash-logback-encoder 版本升级至 7.4
• [升级] skywalking 版本升级至 8.16.0
• [升级] minio 版本升级至 8.5.3
• [升级] fastjson2 版本升级至 2.0.34
• [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.781
• [升级] qiniu-java-sdk 版本升级至 7.13.1
• [升级] alipay-sdk-java 版本升级至 4.35.166.ALL
• [升级] aliyun-sdk-oss 版本升级至 3.16.3
• [升级] jackson 版本升级至 2.15.2

v2.7.12.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.12
• 其它更新
  • [重构] 重新配置并统一 maven repositories 和 pluginRepositories。以 dante-engine dependencies 为核心，删除其它工程中，重复和冲突的配置。
• 依赖更新
  • [升级] mapstruct-processor 版本升级至 1.5.5.Final
  • [升级] maven-gpg-plugin 版本升级至 3.1.0
  • [升级] commons-io 版本升级至 2.12.0
  • [升级] redisson 版本升级至 3.21.3
  • [升级] fastjson2 版本升级至 2.0.32
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.757
  • [升级] alipay-sdk-java 版本升级至 4.35.132.ALL
  • [升级] com.baidu.aip 版本升级至 4.16.16
  • [升级] aliyun-sdk-oss 版本升级至 3.16.3
  • [升级] jackson 版本升级至 2.14.3

v2.7.11.1

• 主要更新
  • [升级] Spring Cloud 版本升级至 2021.0.7
• 依赖更新
  • [升级] redisson 版本升级至 3.21.0
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.748

v2.7.11.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.11
  • [升级] Spring Authorization Server 版本升级至 0.4.2
  • [升级] Debezium 版本及相关基础设施版本升级至 2.2
• 其它更新
  • [漏洞] 修复 Snakeyaml (CVE-2022-1471) 存在反序列化漏洞 和 (CVE-2022-41854) 存在缓冲区溢出漏洞
  • [新增] 新增服务优雅停机支持
  • [优化] 优化数据自动初始化脚本放置位置，与新版本代码创建数据表需要启动两个服务机制进行统一。
  • [修复] 修复自定义社交登录模式中，微信小程序参数获取未补充错误。
• 依赖更新
  • [升级] snakeyaml 版本升级至 2.0
  • [升级] fastjson2 版本升级至 2.0.29
  • [升级] wxjava 版本升级至 4.5.0
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.744
  • [升级] alipay-sdk-java 版本升级至 4.35.110.ALL

v2.7.10.2

• 主要更新
  • [升级] Nacos 版本升级至 2.2.2
  • [升级] Spring Authorization Server 版本升级至 0.4.2
  • [升级] Camunda 版本升级至 7.19.0，同步更新数据库脚本
  • [升级] Skywalking Agent 版本升级至 8.15.0
  • [升级] Antisamy 版本升级至 1.7.3，同步升级 XSS 攻击防护策略配置文件
• 其它更新
  • [优化] 优化 Docker Compose 脚本配置
• 依赖升级
  • [升级] bcprov-jdk15to18 版本升级至 1.73
  • [升级] fastjson2 版本升级至 2.0.28
  • [升级] hutool 版本升级至 5.8.18
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.737
  • [升级] alipay-sdk-java 版本升级至 4.35.107.ALL
• 升级说明
  • 因仓库提交文件大小限制，所以本次发布不在上传 Skywalking Agent 相关 Jar 包，有需要请自行下载。

v2.7.10.1

• 主要更新
  • [新增] 新增 MongoDB 基础 Entity、Repository、Service、Controller 和 MybatisPlus 基础 Controller，方便业务接口代码编写。
• 依赖更新
  • [升级] docker-maven-plugin 版本升级至 0.42.1
  • [升级] redisson 版本升级至 3.20.1
  • [升级] springdoc 版本升级至 1.7.0
  • [升级] fastjson2 版本升级至 2.0.27
  • [升级] hutool 版本升级至 5.8.16
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.731
  • [升级] qiniu-java-sdk 版本升级至 7.13.0
  • [升级] alipay-sdk-java 版本升级至 4.35.101.ALL
  • [升级] aliyun-sdk-oss 版本升级至 3.16.2
  • [升级] xnio 版本升级至 3.8.9.Final

v2.7.10.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.10
  • [升级] Spring Cloud Alibaba 版本升级至 2021.0.5.0
  • [漏洞] 修复 Spring DoS 安全漏洞 (CVE-2023-20861)
  • [漏洞] 修复 commons-fileupload 安全漏洞 (CVE-2023-24998)
• 其它更新
  • [修复] 修复授权码模式登录页面在最新版本 Spring Authorization Server 下被拦截问题
  • [修复] 优化前端 Vite 生产模式下 chunk 打包策略，解决 chunk 不合理设置，产生编译后的代码运行异常，导致前端页面无法正常显示问题。
  • [修复] 修复 docker-compose 脚本中，最新版本 Nacos 缺少新增默认环境变量，导致 Nacos 镜像无法正常启动错误。fix：#I6OMKH (ISSUED by 乌拉松)
  • [修复] 修复 mysql 数据库初始化脚本。fix：#I6OMKH (ISSUED by 乌拉松)
  • [修复] 修复在线文档内容与当前最新版本内容不匹配问题。fix：#I6P1F3 (ISSUED by tao)
• 依赖更新
  • [升级] maven-embedder 版本升级至 3.9.1
  • [升级] maven-compat 版本升级至 3.9.1
  • [升级] tencentcloud-sdk-java 版本升级至 3.1.720
  • [升级] alipay-sdk-java 版本升级至 4.35.83.ALL

v2.7.9.2

• 主要更新
  • [升级] nacos 版本升级至 2.2.1
• 其它更新
  • [修复] 修复 SecurityUtils 无法获取当前登录用户信息问题 fix: #I6KOG6 (ISSUED by 大叔丨小巷)
  • [修复] 修复 Content/Authorize 页面，页面缩放时，页面可能出现空白 fix: #I6KT7R (ISSUED by dens)
• 依赖升级
  • [升级] springdoc 版本升级至 1.6.15
  • [升级] fastjson2 版本升级至 2.0.26
  • [升级] hutool 版本升级至 5.8.15
  • [升级] wxjava 版本升级至 4.4.9.B
  • [升级] mybatis 版本升级至 3.5.13
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.715
  • [升级] alipay-sdk-java 版本升级至 4.35.79.ALL
  • [升级] postgresql 版本升级至 42.6.0

v2.7.9.1

• 主要更新
  • [修复] 修复单体版 MySQL 数据库初始化脚本错误。fix:#I6HRDP (ISSUED by 柳敏莘)
  • [修复] 修复查询接口中包含 properties 数组属性会导致 Gateway UrlDecode 失败的问题 fix:#I6HOLA (ISSUED by dens)
• 依赖更新
  • [升级] docker-maven-plugin 版本升级至 0.42.0
  • [升级] redisson 版本升级至 3.20.0
  • [升级] hutool 版本升级至 5.8.13
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.706
  • [升级] alipay-sdk-java 版本升级至 4.35.65.ALL
  • [升级] log4j 版本升级至 2.20.0

v2.7.9.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.9
  • [升级] Spring Cloud 版本升级至 2021.0.6
• 其它更新
  • [新增] 菜单管理页面增加标题过滤条件

v2.7.8.1

• 主要更新
  • [升级] Spring Authorization Server 版本升级至 0.4.1
  • [升级] Skywalking Agent 版本升级至 8.14.0
• 其它更新
  • [升级] Debezimu 相关组件版本升级至 2.1
  • [删除] 删除 yunpian 短信模块及相关依赖
  • [修复] Dashboard 页面，在切换 Tab 后，echarts 宽度不再自适应，显示成 100px 问题。
  • [修复] 根据新版 axios typescript 定义，修改 axios 核心代码解决类型提示错误。
  • [修复] 修复在最新版本 vite-plugin-dts 环境下，编译模块出现较多提示信息问题。
• 依赖升级
  • [升级] docker-maven-plugin 版本升级至 0.41.0
  • [升级] maven-embedder 版本升级至 3.9.0
  • [升级] maven-compat 版本升级至 3.9.0
  • [升级] redisson 版本升级至 3.19.3
  • [升级] logstash-logback-encoder 版本升级至 7.3
  • [升级] minio 版本升级至 8.5.2
  • [升级] fastjson2 版本升级至 2.0.24
  • [升级] hutool 版本升级至 5.8.12
  • [升级] okhttps 版本升级至 4.0.1
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.697
  • [升级] alipay-sdk-java 版本升级至 4.35.45.ALL
  • [升级] com.baidu.aip 版本升级至 4.16.14
  • [升级] aliyun-sdk-oss 版本升级至 3.16.1
  • [升级] dom4j 版本升级至 2.1.4
  • [升级] jackson 版本升级至 2.14.2
  • [升级] postgresql 版本升级至 42.5.4

v2.7.8.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.8 fix：#I6B4UT
  • [重构] 重构 Athena 工程模块结构，简化该工程多模块结构，删除多余无意义的结构示例性结构，各模块的用途及含义更简洁清晰
• 其它更新
  • [新增] 针对某一类权限校验并不严格的接口，新增只校验是否认证、不校验授权的权限校验策略，以提高权限校验的灵活度，降低权限配置维护的工作量。
  • [新增] 只校验是否认证、不校验授权的权限校验策略配置
  • [修复] 修复极端情况下，权限缓存数据丢失，接口请求将跳过权限验证的潜在安全问题。
  • [修复] 修复 Spring Cloud Gateway 长期运行后出现 io.netty.util.internal.OutOfDirectMemoryError 问题。fix：#I6AZJX (ISSUED by 狂练胸肌李大懒)
  • [优化] 将默认 WebSocket 连接地址设置为 permitAll 权限，跳过资源服务器检测，由 WebSocket 模块自主进行权限校验。
  • [优化] 基于 axios 最新版本 typescript 定义，优化前端 @herodotus/core 模块 axios 核心代码，避免编译过程中出现类型校验错误。
• 依赖更新
  • [升级] jetcache 版本升级至 2.7.3
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.681
  • [升级] alipay-sdk-java 版本升级至 4.35.37.ALL

v2.7.7.5

• 主要更新
  • [新增] 新增融合 Stomp WebSocket、私信、公告等功能的独立消息服务。支持前端与后端采用 WebSocket 和 REST 接口互发消息。
  • [新增] 新增私信、公告发送，及新消息提醒、基于私信对话浏览信息功能
  • [新增] 新增手工解析 Token 信息机制，同时支持 JWT Token 和 Opaque Token。
  • [新增] WebSocket 模块，支持 WebSocket Token 鉴权及登录用户信息解析功能
  • [新增] 新增实时在线用户统计及同步实时刷新功能
• 其它更新
  • [重构] 重构基于 Redis 的 Session 共享配置代码，采用更合理的配置实现分布式微服务 Session 共享
  • [修复] 优化微服务分布式 Session 共享配置，解决共享 Session 不一致问题。
  • [修复] Spring Authorization Server 授权码模式下，WebSocket 获取的 Principal 类型无法解析问题。
  • [修复] Antisamy XSS 校验结果包含换行符，导致 WebSocket 连接异常问题。
  • [修复] 修复 WebSocket 握手阶段获取 Session 异常抛出 NullPointException 问题。

v2.7.7.4

• 主要更新
  • [重构] 重构 Spring Authorization Server OAuth2 相关代码分包和模块结构，逻辑更内聚、职责更清晰、模块引用依赖更简洁
• 其它更新
  • [修复] 修复 XSS Request 包装器 Parameter 方法错误，导致无法获取参数错误
  • [新增] 新增手工解析 Token 信息机制，同时支持 JWT Token 和 Opaque Token。

v2.7.7.3

• 主要更新
  • [重构] 删除 engine-protect 模块，相关代码合并至 engine-rest 模块中
• 其它更新
  • [新增] 在 JWT Token、Opaque Token 和 IdToken 新增用户信息扩展字段，以方便前端直接使用，减少与后端的交互。
  • [修复] 修复 前端使用授权码模式登录，授权码地址多出 "/api" 代理问题。fix: #I69XZC
• 依赖更新
  • [升级] maven-embedder 版本升级至 3.8.7
  • [升级] maven-compat 版本升级至 3.8.7
  • [升级] redisson 版本升级至 3.19.1
  • [升级] minio 版本升级至 3.5.1
  • [升级] fastjson2 版本升级至 2.0.23
  • [升级] wxjava 版本升级至 4.4.8.B
  • [升级] tencentcloud-sdk-java 版本升级至 3.1.678
  • [升级] alipay-sdk-java 版本升级至 4.35.32.ALL

v2.7.7.2

• 主要更新
  • [修复] 修复条件查询 Token 参数错误，导致操作异常抛出 Unable to locate Attribute with the the given name [authorizationCode] 异常错误。fix：#I69CN8

v2.7.7.1

• 主要更新
  • [升级] Spring Boot Admin 版本升级至 2.7.10
• 其它更新
  • [修复] 修复遗漏 Spring Authorization Server 0.4.0 以后新增字段 authorized_scopes 问题
  • [修复] 修复自定义授权模式使用 Refresh Token 重新申请 Token 抛错问题。
• 依赖更新
  • [升级] fastjson2 版本升级至 2.0.22
  • [升级] hutool 版本升级至 5.8.11
  • [升级] wxjava 版本升级至 4.4.7.B
  • [升级] mybatis-plus-boot-starter 版本升级至 3.5.3.1
  • [升级] mybatis-plus-generator 版本升级至 3.5.3.1
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.667
  • [升级] Redisson 版本升级至 3.19.1

v2.7.7.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.7
• 其它更新
  • [升级] docker-maven-plugin 版本升级至 0.40.3
  • [升级] redisson 版本升级至 3.19.0
  • [升级] springdoc 版本升级至 1.6.14
  • [升级] fastjson2 版本升级至 2.0.21
  • [升级] jetcache 版本升级至 2.7.2
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.657
  • [升级] alipay-sdk-java 版本升级至 4.35.9.ALL
  • [升级] qiniu-java-sdk 版本升级至 7.12.1
  • [升级] com.baidu.aip 版本升级至 4.16.13

v2.7.6.1

• 主要更新
  • [升级] Nacos 版本升级至 2.2.0
  • [升级] Spring Boot Admin 版本升级至 2.7.9
• 其它更新
  • [重构] 前端 API 接口调用，修改为 proxy 代理模式，解决前后端跨域导致前端不创建 Cookie，后端 Session Id 不一致，Session 共享不生效问题。
  • [修复] 修复华为云短信发送请求体类型设置错误
  • [修复] 修复 MySQL 数据库初始化脚本中 JSON 数据格式错误，导致运行抛出参数校验错误问题
• 依赖更新
  • [升级] redisson 版本升级至 3.18.1
  • [升级] wxjava 版本升级至 4.4.6.B
  • [升级] dysmsapi20170525 版本升级至 2.0.23
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.648
  • [升级] alipay-sdk-java 版本升级至 4.35.0.ALL
  • [升级] aliyun-sdk-oss 版本升级至 3.16.0

v2.7.6.0

• 主要更新
  • Spring Boot 版本升级至 2.7.6
• 其它更新
  • [修复] 解决使用 edge 浏览器并使用 feign，报错 Unexpected char 0x0a（PR by 狂练胸肌的李大懒）
  • [修复] 修复前端唯一性字段在新建、编辑不同状态下校验不准确、状态不合理问题。解决导致编辑状态下唯一性字段数据未修改仍会校验失败问题。
  • [修复] 优化微服务分布式 Session 共享配置，解决共享 Session 不一致问题。
  • [新增] 数据初始化脚本补充 OIDC 客户端注册相关信息
• 依赖更新
  • [升级] fastjson2 版本升级至 2.0.20
  • [升级] dysmsapi20170525 版本升级至 2.0.23
  • [升级] aliyun-java-sdk-core 版本升级至 4.6.3
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.641
  • [升级] alipay-sdk-java 版本升级至 4.34.71.ALL
  • [升级] aliyun-java-sdk-green 版本升级至 3.6.6
  • [升级] postgresql 版本升级至 42.5.1
  • [升级] jackson 版本升级至 2.14.1

v2.7.5.3

• 主要更新
  • [升级] Spring Authorization Server 版本升级至 0.4.0
  • [重构] 按照 Spring Authorization Server 0.4.0 最新代码结构和 API 用法，重构认证授权相关代码。
• 其它更新
  • [新增] 新增 Token Settings 授权码模式 Code 有效时间字段。
  • [优化] OAuth2 Application 中 accessTokenTimeToLive、refreshTokenTimeToLive、authorizationCodeTimeToLive 属性的默认值，修改为与 Spring Authorization Server TokenSettings 一致。
  • [优化] 优化数据库初始化脚本中的初始数据，与 Spring Authorization Server 0.4.0 最新代码适配
  • [优化] 优化分布式微服务 Session 共享配置。解决 Session 共享在 Gateway 中，出现注入重复导致无法启动问题。
  • [升级] 升级 Antisamy XSS 攻击防护规则脚本。
• 依赖更新
  • [升级] antisamy 版本升级至 1.7.2
  • [升级] springdoc 版本升级至 1.6.13
  • [升级] minio 版本升级至 8.4.6
  • [升级] fastjson2 版本升级至 2.0.19
  • [升级] Hutool 版本升级至 5.8.10
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.633
  • [升级] alipay-sdk-java 版本升级至 4.34.52.ALL

v2.7.5.2

• 主要更新
  • [升级] Spring Cloud 版本升级至 2021.0.5
  • [升级] Skywalking Agent 版本升级至 8.13.0
  • [新增] 在 Nacos 中增加 logback 配置，新增服务可外部化动态读取 logback.xml 配置模式。以便于更加灵活的进行日志输出配置。
  • [新增] 外部配置 logback.xml 中，增加 Skywalking 日志上报、ELK 日志中心日志收集、Skywalking TraceId 等支持。同时提供常规及 MDC 两种配置。
  • [新增] 在统一响应实体 Result 增加 TraceId 信息，在开启 Skywalking Tracing 的情况下，可在返回结果中，统一增加 TraceId，方便跟踪和调试。
• 其它更新
  • [修复] 优化 Gateway 请求信息拦截机制，增加对 Feign 内部无权限标记的拦截，修复内部接口被外部直接调用的安全漏洞
  • [升级] 升级 Camunda Open API 描述文件版本至 7.18.0
  • [新增] 新增 logback-spring.xml 和 logback-spring-mdc.xml 两个 Nacos 配置文件
• 依赖升级
  • [升级] jackson 版本升级至 2.14.0
  • [升级] fastjson2 版本升级至 2.0.18
  • [升级] wxjava 版本升级至 4.4.4.B
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.627
  • [升级] qiniu-java-sdk 版本升级至 7.12.0
  • [升级] alipay-sdk-java 版本升级至 4.34.47.ALL

v2.7.5.1

• 主要更新
  • [升级] Spring Boot Admin 版本更新至 2.7.7
  • [修复] 修复在 Opaque Token 格式下，通过客户端模式(Client Credentials) 获取 Token 后，基于 Scope 进行接口权限验证失败，出现"OAuth2ClientAuthenticationToken is not in the allowlist. If you believe this class is safe to deserialize, please provide an explicit mapping using Jackson annotations or by providing a Mixin" 问题。
• 其它更新
  前端尝鲜版（dante-cloud-ui monorepo 分支）增加体验性功能
  • [新增] API 模块封装 Camunda Deployment、ProcessDefinition、ProcessInstance 相关操作 API，结合 Camunda API 说明封装相关 Typescript 声明文件。
  • [新增] 新增 Camunda Modeler 在线编辑结果上传部署至服务器端功能。
  • [新增] 前端增加 Apps Widgets 列表功能，可方便快捷地进入流程编辑器和动态表单设计器界面。
• 依赖更新
  • [升级] fastjson2 版本升级至 2.0.17
  • [升级] jackson 版本强制升级至 2.14.0-rc3
  • [升级] wxjava 版本升级至 4.4.3.B
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.616
  • [升级] alipay-sdk-java 版本升级至 4.34.22.ALL
  • [升级] com.baidu.aip 版本升级至 4.16.12
  • [升级] qiniu-java-sdk 版本升级至 7.12.0
• 友情提示
  • 如使用阿里 Maven 镜像，出现本项目或其它依赖包无法下载的情况，请切换其它 Maven 镜像，比如腾讯 Maven 镜像。
  • 在 Maven Settings 文件中，将所需使用的 Maven Mirror 设置为第一个即可。

v2.7.5.0

• 重要更新

  • [升级] Spring Boot 版本升级至 2.7.5
  • [升级] Debezimu 版本升级至 2.0，相关 Docker Compose 中配置 Debezimu Kafka Zookeeper 镜像版本同步升级至 2.0。
  • [变更] 代码开发、编译以及 Docker 基础镜像所使用 JDK 全面更换为 Bellsoft Liberica OpenJDK 发行版，以避免 Oracle JDK 版权问题。仍旧兼容 Oracle JDK，原有自主封装 Oracle JDK 已不再使用。fix：#I5WRXI (ISSUED by 疯狂的狮子 Li)
  • [变更] 修改部分核心代码结构和依赖关系，严格遵循最小依赖的原则，规避模块依赖关系中引入过多的不必要依赖，引起冗余的组件或 Bean 注入问题。

• 其它更新

  • [新增] 增加腾讯备选 Maven 仓库配置，以临时解决本月阿里仓库停更问题
  • [优化] 优化 Recluse SMS 短信模块依赖配置，将通用依赖改为仓库下载方式。
  • [优化] 修改 MySQL JDBC Driver 依赖 ArtifactId，替换为最新 ID，以规避 Maven 编译出现 WARN 提示
  • [修复] 修复前端工程中，Scope 配置接口权限功能抛错导致操作异常问题。

• 依赖升级

  • [升级] transmittable-thread-local 版本升级至 2.14.2
  • [升级] fastjson2 版本升级至 2.0.16
  • [升级] hutool 版本升级至 5.8.9
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.611

v2.7.4.5

• 重要更新

  • [核心组件升级] Spring Boot Admin 版本升级至 2.7.6
  • [核心组件升级] Nacos 版本升级至 2.1.2
  • [核心组件升级] Camunda 版本升级至 7.18.0，同时更新 Camunda Open API 描述文件
  • [核心组件升级] 自主封装 Oracle JDK 版本升级至 8u341, 系统所涉及的所有 Docker 均已修改为使用该版本。该镜像已经上传至 Docker Hub，可以直接使用。

• 其它更新

  • [修复] 修复防刷机制控制范围过窄，缺少对用户标识的区分问题。fix: #I5WF5O (ISSUED by 我问这瓜保熟吗)
  • [优化] 优化系统登录成功记录代码，增加代码健壮性。

• 依赖更新

  • [升级] springdoc 版本至 1.6.12
  • [升级] transmittable-thread-local 版本至 2.14.1
  • [升级] tencentcloud-sdk-java 版本至 3.1.609

• 友情提示

  • 本月阿里云 Maven 仓库升级，暂停同步更新，新发布的包均无法从阿里云 Maven 仓库更新。请直接使用中央仓库或增加其它备份 Maven 仓库镜像

v2.7.4.4

• 重要更新
  • [新增] 扩展 Spring Authorization Server 授权码模式(AuthorizationCode), 在授权码模式返回 Token 中增加系统用户信息，减少二次请求获取用户信息
  • [新增] 在原有 ResourceOwnershipPassword、SocialCredentials 认证模式基础上，补充增加 OIDC IdToken 支持。
  • [新增] 扩展 OIDC IdToken 及 OIDC /userinfo 端点信息内容，与现有用户权限体系融合，支持使用 Opaque Token 读取并解析用户信息。
  • [优化] 整体优化 AuthorizationCode、ClientCredentials、ResourceOwnershipPassword、SocialCredentials 四种认证模式，除保留原有 JWT Token 的所有支持内容外，对 OIDC IdToken、Opaque Token 与现有权限体系进行了全面融合与支持
  • [安全] 修复 jackson-databind 拒绝服务漏洞 (CVE-2022-42003)
• 其它更新
  • [重构] 重构自定义 AuthorizationCode、ClientCredentials、ResourceOwnershipPassword、SocialCredentials 四种认证模式代码，抽象创建 AccessToken、RefreshToken、IdToken 等操作公共代码，代码逻辑更清晰易懂，同时减少重复冗余代码。
  • [重构] 重构 oauth2ResourceServer 配置代码，统一资源服务器 Opaque Token 和 JWT Token 切换策略化配置逻辑。
  • [修复] 在 OAuth2 OIDC 认证方式下，/userinfo 接口调用始终为 401 问题
  • [修复] 修复开启 Session 共享功能后，Gateway Session 相关内容注入重复冲突问题。
  • [修复] 在 AuthorizationCode、SocialCredentials 认证模式下，前端菜单加载异常问题。
  • [新增] 前端新增 Spring Authorization Server 授权码模式(AuthorizationCode) 登录方式。
  • [新增] 优化前端 OAuth2 认证所有接口代码，新增 OIDC IdToken 开关配置，在前端即可根据使用需求决定使用 OIDC (OpenID Connect) 模式还是传统 OAuth2 模式。
  • [优化] 优化前后端用户基本信息提供和使用机制。后端会根据前端 IdToken 开启与否状态，策略化提供 IdToken 或自定义 Token 补充用户信息(注：两种方式均无需通过二次请求后端获取用户信息)。
  • [优化] 前端 echarts 使用方式，变更为按需加载，解决前端工程调试过程中，Dashboard 页面加载缓慢问题。
• 依赖更新
  • [升级] commons-text 版本至 1.10.0
  • [升级] tencentcloud-sdk-java-sms 版本至 3.1.608
  • [升级] alipay-sdk-java 版本至 4.34.14.ALL

v2.7.4.3

• 主要更新

  • [新增] 新增 Opaque Token (不透明令牌) 支持，并将其设置为默认 Token 格式，降低 JWT Token 被捕获解析的风险。仍旧保留 JWT Token 格式支持，可通过修改配置参数进行切换。
  • [重构] 使用 Spring Authorization Server 标准的 Token 废弃机制，重构同一账号在同类型终端异处登录自动踢出(Kick Out)前一个登录用户功能。
  • [修复] 结合 Opaque Token 修复 Kick Out 不生效问题。(注：Kick Out 仅在 Opaque Token 格式下有效。因 JWT Token 自身机制以及 Spring Authorization Server Token 验证实现方式与 Spring Security OAuth 的不同，使用 JWT Token 仅能实现 Token 过期验证，是无法实现 Kick Out 功能 )
  • [新增] Monorepo 版前端工程新增 Dante Cloud 授权码登录预览功能

• 其它更新

  • [重构] 重构部分枚举类，新增 Target 枚举，统一所有涉及本地及远程判断的枚举。
  • [重构] 由于 Okhttps 大版本升级，包名进行了变更，因此涉及一部分代码修改重构。
  • [删除] 删除无用的、自定义的 OAuth2ClientAuthorizationToken 类。
  • [删除] 删除 AuthorizationServerConfiguration 中，冗余的 Authorization Server 配置
  • [修复] 修复单体版参数配置错误，导致启动抛错问题。
  • [优化] 结合 Opaque Token 机制，优化前端工程应用管理功能。

• 依赖更新

  • [升级] mapstruct-processor 版本至 1.5.3.Final
  • [升级] bcprov-jdk15to18 版本至 1.72
  • [升级] okhttps 版本至 4.0.0
  • [升级] dysmsapi20170525 版本至 2.0.22
  • [升级] alipay-sdk-java 版本至 4.34.8.ALL

• 升级指南

  本次更新涉及系统核心逻辑变化，升级新版代码涉及核心参数和数据的变更。如果是全新部署，可以跳过以下内容；如果是在系统，可以参考以下内容进行最小化修改。

  1. 修改 dante-cloud-platform.yaml 配置，增加 opaque 相关配置，具体修改内容参见工程中对应的配置文件。
  2. 手动修改数据和参数
     • 修改数据表 oauth2_registered_client 中 token_settings 字段 JSON 数据，将其中 OAuth2TokenFormat 的值 “self-contained” 修改为 “reference”。
     • 修改 数据表 oauth2_application 中 access_token_format 字段的值，将其值从“0”改“1”
     • 修改完成之后，需要清理 Redis 缓存，并重新启动服务。

v2.7.4.2

• 重要更新
  • [新增] 基于 pnpm 的 monorepo 模式新版前端应用，预览版上线
    • 该版本基于 pnpm，采用 monorepo 模式对前端工程进行重构
    • 抽取 utils、components、apis、bpmn-designer 等相关代码，形成共享模块。
    • 共享模块已进行优化配置，可编译成独立的组件，单独以组件形式进行发布。
    • 代码以共享模块的方式进行单独维护开发，降低现有工程代码复杂度，便于后续功能的扩展和代码的复用。
  • [重构] 重构现有前端工程 TabView 相关代码和实现逻辑
    • 完全基于 Quasar QRouteTab 组件的自身特性对 TabView 进行重构，将 TabView 与 Vue-Router 更好的融合，实现逻辑更清晰也更易维护。
    • 新增 Tab 页局部刷新、关闭左侧、关闭右侧以及 Tab 页面保留等 TabView 操作功能
    • 重新设计常规 Tab 页面、详情 Tab 页面，开启、关闭、跳转、显示位置等操作逻辑。
    • 将 TabView 操作与 Tab 当前各种状态有机结合，规避不合理 Tab 操作出现。
    • 重构 TabView Pinia Store 操作代码逻辑，合并相近逻辑，删除重复或无用代码。
• 其它更新
  • [修复] 在最新 Vite 和 Vue-tsc 环境下出现 Write operation failed: computed value is readonly 问题。
  • [修复] 优化单体版本应用配置，修正第三方登录配置错误，补充单体版多租户配置
  • [优化] 优化 Nacos 配置文件，默认关闭多租户配置。
• 依赖更新
  • [升级] redisson 版本至 3.17.7
  • [升级] fastjson2 版本至 2.0.15
  • [升级] dysmsapi20170525 版本至 2.0.21
  • [升级] alipay-sdk-java 版本至 4.34.0.ALL
• 额外说明
  • 想要尝鲜 pnpm monorepo 版本前端，请检出 dante-cloud-ui 工程中，monorepo 分支代码。
  • 构建 monorepo 版本前端，是为扩展更多功能、增加应用级功能做铺垫。
  • 微前端架构技术已经走通，未在 monorepo 版本中直接实现，主要考虑到微前端更适合大型前端拆解、多前端项目整合情况。构建一套完善的微前端应用，研发投入大、潜在问题多、使用复杂度高，并不适合本项目目前大多数用户的实际用途。采用一些性价比更高的替代方案，比如说 Nginx 的多应用似乎更可取。因此，目前尝试推出 monorepo 版前端，作为基础或过渡版本。在此版本基础之上，构建"微前端"应用，特别是基于 Micro-App 的微前端会非常容易。会适时并结合用户需求，再考虑是否转换为微前端架构前端应用。

v2.7.4.1

• 重要更新
  • [新增] 新增 Spring Authorization Server 同一账号，在同类型终端异处登录自动踢出(Kick Out)前一个登录用户功能。可通过配置参数修改是否开启。该项功能与应用安全合规性检查项：同一终端不允许重复登录互斥(即不能同时开启，同一时间只能开启一项)。
• 其它更新
  • [优化] 优化 Nacos 配置文件，删除 Redisson 统一开关配置，默认不启用 Redisson。
  • [优化] 改进在线文档部分内容描述不正确问题 。fix: #I5TSEM (ISSUED by 等待是如此漫长)
  • [优化] 优化数据自动初始化脚本放置位置，与新版本代码创建数据表需要启动两个服务机制进行统一。
  • [修复] 增加 Redisson 密码配置，修复在 Redis 5 版本下设置密码后 Redisson 无法连接 Redis 问题。fix: #I5TS0Y (ISSUED by 等待是如此漫长)
  • [修复] 修复前端工程，配置人员归属功能人员选择页面无法点开的问题。
  • [修复] 修复前端工程，使用最新版 vue-router 会在控制台抛出 You are running the esm-bundler build of vue-i18n. It is recommended to configure your bundler to explicitly replace feature flag globals with boolean literals to get proper tree-shaking in the final bundle. 问题
  • [修复] 修复删除无用 Token 抛出 No EntityManager with actual transaction available for current thread 错误
• 依赖更新
  • [升级] minio 版本至 8.4.5
  • [升级] hutool 版本至 5.8.8
  • [升级] wxjava 版本至 4.4.2.B
  • [升级] dysmsapi20170525 版本至 2.0.20
  • [升级] tencentcloud-sdk-java 版本至 3.1.600
  • [升级] alipay-sdk-java 版本至 4.33.60.ALL
  • [升级] aliyun-sdk-oss 版本至 3.15.2
  • [升级] snakeyaml 版本至 1.33
  • [升级] 前端工程所有依赖包均升级至最新版本

v2.7.4.0

• 重要更新
  • [升级] Spring Boot 版本升级至 2.7.4
  • [修复] 优化 Spring Authorization Server 客户端模式下，根据 Scope 分配权限逻辑。使用统一逻辑修复客户端模式下，Scope 权限对应接口始终返回“没有权限访问”问题
• 其它更新
  • [修复] 修复 OAuth2 Scope 分配权限接口实现逻辑错误问题。
  • [修复] 修复前端 OAuth2 Scope 分配权限功能传递参数不足，导致权限无法增加问题。
  • [修复] 修复在新版本 Spring Boot 环境下，@EntityListeners 复发获取 ApplicationContext 导致角色权限变更抛空错误
  • [修复] 优化前端 Token 过期校验逻辑，修复在使用 Refresh Token 的情况下，不应该再进行 Token 是否过期校验，导致 Refresh Token 无法使用问题。fix： #I5SKFS (ISSUED by 狂练胸肌的李大懒)
  • [修复]修复前端工程打卡编辑页面后，调整浏览器大小后，所有 tab 都显示空白问题。fix：#I5SB49 (ISSUED by SimonLiu)

v2.7.3.6

• 重要更新
  • [升级] Spring Boot Admin 版本升级至 2.7.5
  • [升级] 前端工程 Camunda Bpmn 在线编辑器核心组件大版本升级
  • [安全] 强制升级 xnio 版本至 3.8.8.Final，修复安全漏洞 (CVE-2022-0084)
• 其它更新
  • [新增] 新增 Spring Authorization Server 历史 Token 清理逻辑
  • [修复] 前端工程编译结果与 Nginx 一起打包为 Docker 后，在浏览器刷新页面出现 404 问题。
  • [优化] 优化 Token 过期检测逻辑，调整时钟偏移(Clock Skew)，与 Spring Security OAuth2 Jose 默认实现逻辑保持一致。fix: #I5RWGA（ISSUED by 狂练胸肌李大懒）
  • [优化] 优化前端封装 Axios 代码中阻止重复提交属性名称，将其修改为更容易理解的变量名称。
  • [优化] 优化自定义 Spring Authorization Server JPA 模块部分查询操作，启用基于 Jetcache 自定义的 JPA 多级缓存支持，提升数据查询效率
  • [优化] 优化部分代码日志输出级别，提升控制台日志输出内容的可聚焦性
• 依赖更新
  • log4j2 版本升级至 2.19.0
  • minio 版本升级 8.4.4
  • fastjson2 版本升级至 2.0.14
  • hutool 版本升级至 5.8.7
  • mybatis 版本升级至 3.5.11
  • tencentcloud-sdk-java-sms 版本升级至 3.1.597

v2.7.3.5

• 重要更新
  • Spring Boot Alibaba 版本升级至 2021.0.4.0
  • 自主封装 Oracle JDK 版本升级至 8u333, 系统所涉及的所有 Docker 均已修改为使用该版本。该镜像已经上传至 Docker Hub，可以直接使用。
  • 自主封装 Sentinel Dashboard 基于 Sentinel 1.8.5 进行了全面升级。
    • Sentinel Dashboard 基础 Spring Boot 版本已升级至 2.5.14 (Spring Boot 版本升级至 2.6.X 或 2.7.X，会出现无法登陆的情况，所以暂时只能升级至 2.5. X)
    • 使用 Dante Engine 统一代码，优化自定义的基于 InfluxDB 的 Sentinel Dashboard 数据持久化存储代码及 Dockerfile 参数，可通过修改 docker-compose 中的参数动态开启或关闭持久化功能
    • 使用 Dante Engine 统一代码，优化自定义的基于 Nacos 的 Sentinel Dashboard 流控规则存储及 Dockerfile 参数，可通过修改 docker-compose 中的参数动态开启或关闭保存流控规则至 Nacos 功能。
    • 该镜像已经上传至 Docker Hub，通过命令 docker push herodotus/sentinel-dashboard:latest(或者 1.8.5) 可以直接获取使用。
• 其它更新
  • [修复] 用户文档列表中无结果时也要更新列表数据,防止不在第一页时发两遍请求。(感谢 狂练胸肌李大懒提交的 PR)
  • [修复] 强制升级部分组件依赖的 snakeyaml 版本， 修复低版本 snakeyaml 携带的 CVE-2022-25857，CVE-2022-38752，CVE-2022-38749 安全漏洞问题。
  • [优化] 增加是否使用自动获取 Refresh Token 判断，在使用 Refresh Token 模式下，禁用关闭浏览器自动最退出系统功能。
  • [升级] 前端工程 Vite 版本升级至 3.1.1
• 依赖更新
  • log4j 版本升级至 2.18.0
  • wxjava 版本升级至 4.4.1.B
  • aliyun-java-sdk-core 版本升级至 4.6.2
  • tencentcloud-sdk-java-sms 版本升级至 3.1.593
  • alipay-sdk-java 版本升级至 4.33.42.ALL

v2.7.3.4

• 重要更新
  • [升级] Spring Cloud 版本升级至 2021.0.4
  • [升级] Skywalking Agent 版本升级至 8.12.0
  • [新增] 基于 JPA 的多租户系统支持，支持 Database 和 Schema 两种模式，可通过配置进行开启和关闭。
  • [重构] 基于 JetCache 的自定义 Hibernate 二级缓存，支持多租户模式下数据的分布式多级缓存。
  • [重构] 重构前端详情页面参数的传递方式，解决 vue-router 自 4.1.4 版本不再建议使用 push param 传递参数而导致的新增、编辑功能不可用问题。
• 其它更新
  • [优化] 优化部分代码日志输出内容及日志输出级别
  • [优化] 优化基于 JetCache 的 Hibernate 二级缓存代码
  • [升级] 升级 antisamy XSS 防护配置文件
  • [修复] 临时修复 BPMN.js 在线工作流编辑器，在第一次加载页面时抛错无法显示 Canvas 和 Property Panel 问题。
  • [修复] 第三方社交登录 logo 在生产环境下无法正常显示问题。
  • [优化] 优化服务配置，将第三方社交登录相关配置移至 Nacos 方便修改。
• 依赖更新
  • antisamy 版本升级至 1.7.1
  • hutool 版本升级至 5.8.6
  • tencentcloud-sdk-java-sms 版本升级至 3.1.590
  • fastjson2 版本升级至 2.0.13
  • alipay-sdk-java 版本升级至 4.33.39.ALL

v2.7.3.3

• 主要更新
  • [新增] 前端根据后端配置的第三方社交登录信息，在前端登录页面自动生成第三方社交登录按钮。新增常见第三方社交登录 logo 图标，根据后端配置自动显示。
  • [新增] 新增 JustAuth 的第三方社交登录前端 Callback 处理逻辑，让第三方社交登录逻辑更合理清晰
• 其它更新
  • [修复] 修改社交登录示例配置格式，解决错误配置格式导致第三方社交登录核心配置信息无法注入问题
  • [修复] 社交登录处理器 Bean 名称与 微信小程序登录处理器 Bean 名称混淆问题。
  • [优化] 优化外部登录接入模块 (Access 模块) 部分 Exception 代码，将其融入平台整体错误体系。
  • [优化] 去除 dante-engine 中无用的依赖配置
• 依赖更新
  • tencentcloud-sdk-java 版本升级至 3.1.587
• 友情提示
  • 目前前端工程支持第三方社交登录，必须改为 History 模式，暂不支持 Hash 模式。
  • 因很多常用第三方登录，需要以企业信息进行注册。所以第三方登录并未覆盖所有情况以及参数测试，需根据实际使用情况自行增减。也欢迎提交 PR。

v2.7.3.2

• 主要更新
  • [修复] 强制升级 postgresql jdbc driver 依赖包版本，解决 spring boot 2.7.3 默认依赖低版本 postgresql jdbc driver 携带的 SQL 注入漏洞（CVE-2022-31197）问题。
  • [修复] 修复前端工程 keep-alive 不生效问题。fix：#I5ODHH （ISSUE By jokeway）
  • [修复] 修复前端工程因升级 vue-router 最新版本，导致修改和编辑功能不可用问题。
  • [修复] 修复前端工程因升级 Bpmn 和 Camunda 相关依赖包导致工作流在线编辑不可用问题。
  • [重构] 将 Influxdb 相关模块调整至新增的 NoSQL 模块组，删除原有 temporal 相关模块。
  • [新增] 新增 CouchDB 数据库集成模块
  • [删除] 删除已有 Cmdb 相关模块和代码，以及 SQL 脚本配置，减少用户对该模块的误解。
• 依赖更新
  • redisson 版本升级至 3.17.6
  • springdoc 版本升级至 1.6.11
  • alipay-sdk-java 版本升级至 4.33.26.ALL
• 友情提示
  • 最新版本 vue-router、Bpmn 和 Camunda 相关组件存在破坏性升级，会导致前端工程已有功能不可用，因此不要随意升级依赖包版本，使用工程指定版本。

v2.7.3.1

• 主要更新
  • [新增] 前端工程新增用户名非法字符检查，仅支持数字、字符、下划线和减号
  • [新增] 前端工程新增日志审计数据导出为 Excel 功能
  • [修复] 前端 Tabview 组件，当只剩一个 Tab 时，不应允许再关闭问题。(感谢 jokeway 提交的 PR)
  • [修复] 前端解决当打开的 Tab 超出当前显示区域时，新开的 Tab 无法定位并显示的问题。(感谢 jokeway 提交的 PR)
  • [修复] 优化应用安全合规性检查项：统一终端不允许重复登录相关代码逻辑。解决原有逻辑删除已有认证信息，导致 refresh token 失效问题。fix：#I5NYX2 ( ISSUE By 狂练胸肌李大懒)
  • [修复] 修复系统错误反馈信息配置错误。fix：#I5N1VA ( ISSUE By 未来)
  • [优化] 优化基于 JPA 的自定义 Spring Authorization Server AuthorizationService 数据访问代码。
  • [优化] 优化 Spring Authorization Server 错误信息描述和错误码，可以更加准确的区分 Access Token 和 Refresh Token 过期的状态。
• 依赖更新
  • jetcache 版本升级至 2.7.0 正式版
  • fastjson2 版本升级至 2.0.12
  • weixin-java-sdk 版本升级 4.4.0
  • alipay-sdk-java 版本升级 4.33.12.ALL
  • com.baidu.aip 版本升级至 4.16.11

v2.7.3.0

• 主要更新
  • [升级] Spring Boot 版本升级至 2.7.3
  • [新增] 新增 OAuth2 Token 过期后，用户可无感知自动获取新 Token 机制。(感谢 狂练胸肌李大懒 提交的 PR)
• 其它更新
  • [修复] 应用安全合规代码，在容器环境下，受监控 Agent 影响，产生 Consider injecting the bean as one of its interfaces orforcing the use of CGLib-based proxiesby setting proxyTargetClass=true on @EnableAsync and/or @EnableCaching 错误问题。
  • [修复] 修复自定义 Spring Authorization Server 认证模式，因 Token 必要参数缺失，导致通过 Refresh Token 获取新 Access Token 时抛出空指针错误。fix: #I5MF3B
• 依赖更新
  • protobuf-java 版本升级至 3.21.5
  • springdoc 版本升级至 1.6.10
  • tencentcloud-sdk-java-sms 版本升级至 3.1.572

v2.7.2.6

• 主要更新
  • [新增] 增加手机短信验证码登录沙盒验证测试模式。在此模式下，无须开通短信通道，就可以进行手机短信验证码注册和登录验证测试。
• 其它更新
  • [修复] 强制升级 tea-xml 和 dom4j 依赖包版本，去除低版本 dom4j 携带的安全漏洞问题。
  • [修复] 修复 Spring Authorization Server 自定义 Social Credentials 认证模式下，认证类型校验错误，导致手机验证码登录失败问题。
  • [修复] 修复自定义 Social Credentials 社会化登录参数解析器配置遗漏，导致无法正确解析参数错误。
  • [修复] 在远程访问获取用户数据模式下，Social Credentials 社会化登录第三方用户交换处理器未正确注入问题。
  • [修复] 自定义 Social Credentials 认证模式，前后端数据传输的加密数据解密失败问题。
  • [修复] OpenFeign 远程调用接口，传递实体对象数据丢失问题。
  • [优化] 优化自定义 Social Credentials 认证模式手机验证码登录等参数合规性校验逻辑。
  • [优化] 优化 Nacos 输出至日志中心的服务日志数据级别及包含内容配置
  • [优化] 优化前端登录页面，开放手机验证码登录功能。
  • [优化] 优化前端工程生产模式打包脚本配置

v2.7.2.5

• 重要更新
  • Nacos 版本升级至 2.1.1。已提供最新版本 Nacos 数据库脚本。
• 其它更新
  • [修复] 前端分页组件，选择"全部"选项，导致后端接口校验返回参数错误问题。fix #I5M1G6
  • [修复] 前端登录认证过期后，浏览器存储无效 Token，再次启动应用过期提示框会被 loading 效果覆盖问题。fix #I5LKYI
  • [修复] 在 MySQL 数据库环境下，如果编码为非 utf-8 的情况下，导致 sys_social_user 表无法创建的问题。fix #I5LWGK
  • [修复] 以 jar 包形式运行单体版状态下，找不到依赖问题。
  • [优化] Dockerfile 中增加默认编码设置，防止在未设置语言环境的操作系统中，出现乱码导致请求内容包含特殊字符被 XSS 拦截而产生反序列化问题。
• 依赖更新
  • dysmsapi20170525 版本升级至 2.0.18
  • tencentcloud-sdk-java-sms 版本升级至 3.1.568
  • alipay-sdk-java 版本升级至 4.33.1.ALL

v2.7.2.4

• 主要更新
  • Spring Boot Admin 版本升级至 2.7.4
  • JetCache 版本升级至 2.7.0.RC3，以支持服务多实例环境下，服务本地缓存的同步。
  • 根据 JetCache 2.7.0 版本的变化，调整 Nacos 相关配置。
  • 优化重构所有 Stamp 相关代码，将所有标记为过时的 @CreateCache 相关代码，全部修改为最新的代码化配置形式。
• 依赖更新
  • WxJava 版本升级至 4.3.9.B
  • Aliyun-java-sdk-core 版本升级至 4.6.1
  • Dysmsapi20170525 版本升级至 2.0.17
  • Tencentcloud-sdk-java 版本升级至 3.1.565
  • Alipay-sdk-java 版本升级至 4.31.84.ALL

v2.7.2.3

重磅！Dante Cloud 所有核心代码全部开源。

• 主要更新

  • 接口权限鉴权：全面整合 @PreAuthorize 注解权限与 URL 权限，通过后端动态配置，无须在代码中配置 Spring Security 权限注解以及权限方法，即可实现接口鉴权以及权限的动态修改。采用分布式鉴权方案，规避 Gateway 统一鉴权的压力以及重复鉴权问题
  • 动态权限数据分发：采用分布式服务独立鉴权方案，Spring Security @PreAuthorize 的权限注解、权限方法以及 URL 权限，通过后端动态配置后，实时动态分发至对应服务。
  • User 数据策略访问：OAuth2 UserDetails 核心数据支持直连数据库获取和 Feign 远程调用两种模式。OAuth2 直连数据库模式性能更优，Feign 访问远程调用可扩展性更强。可通过配置动态修改采用策略方式。
  • 手机短信验证码注册认证：采用自定义 OAuth2 授权模式，使用统一 Token 接口，实现手机验证码登录认证，与平台为统一体系，统一返回OAuth2 Token，支持服务接口鉴权
  • 第三方系统社交注册认证：集成 JustAuth，采用自定义 OAuth2 授权模式，使用统一 Token 接口，实现基于 JustAuth 实现第三方系统社交登录认证，与平台为统一体系，统一返回 OAuth2 Token，支持服务接口鉴权。所有 JustAuth 支持的第三方系统均支持。
  • 微信小程序注册认证：采用自定义 OAuth2 授权模式，使用统一 Token 接口，实现支持微信小程序登录认证，与平台为统一体系，统一返回 OAuth2 Token，支持服务接口鉴权。
  • 其它方式注册认证：采用策略模式对外部系登录认证和用户注册进行接入支持，采用 OAuth2 默认认证接口。目前未集成的外部系统，可参考标准，适当增减参数，即可支持接入。
  • 多通道 SMS 集成：集成阿里，百度，中国移动，华为，京东，极光，网易，七牛，腾讯，又拍，云片等平台短信发送通道。可通过配置动态选择具体使用通道。支持多模版定义以及模版参数顺序控制
  • 微信小程序订阅消息：支持微信小程序订阅消息发送。提供订阅消息模版工厂，可根据自身业务需求，编写少量代码既可以拓展支持新订阅消息模版。

• 依赖更新：

  • hutool 版本升级至 5.8.5
  • docker-maven-plugin 版本升级至 0.40.2
  • tencentcloud-sdk-java-sms 版本升级至 3.1.561

v2.7.2.2

[1]、特别说明

Dante Cloud (但丁，原 Eurynome Cloud) 正式加入 Dromara 开源社区。Dante Cloud 将继续秉承“简洁、高效、包容、务实”的理念，不断地深耕细作、去粗取精，用心打造一款适应未来信息化建设需求的精致产品。同时，与 Dromara 开源社区以及社区中所有的优秀人才一起互相扶持、并肩前行，创造更多、更好、更精的产品以回馈社会，促进软件开源的发展。

谢谢大家对 Eurynome Cloud 支持与厚爱，希望大家继续给与 Dante Cloud  以及  Dromara 开源社区关注与支持

[2]、为什么更名为  Dante Cloud

原项目名称 Eurynome Cloud，很多朋友都反映名字太长、读起来拗口、不容易记等问题。因此在加入 Dromara 开源社区之际，将名字进行了变更。

Dante，即但丁·阿利基耶里(公元 1265 年-公元 1321 年)，13 世纪末意大利诗人，现代意大利语的奠基者，欧洲文艺复兴时代的开拓人物之一，以长诗《神曲》(原名《喜剧》)而闻名，后来一位作家叫薄伽丘将其命名为神圣的喜剧。

他被认为是中古时期意大利文艺复兴中最伟大的诗人，也是西方最杰出的诗人之一，最伟大的作家之一。恩格斯评价说：“封建的中世纪的终结和现代资本主义纪元的开端，是以一位大人物为标志的，这位人物就是意大利人但丁，他是中世纪的最后一位诗人，同时又是新时代的最初一位诗人”

更名为 Dante Cloud，寓意本项目会像恩格斯对但丁的评价一样，在行业变革的时期，可以成为一款承上启下，助力企业信息化建设变革的产品。

[3]、本次更新内容

由于项目名称的变更，为了降低和规避使用者产生不必要的误解，因此对项目代码、模块、Nacos 配置、初始数据进行了同步修改。

• 主要更新
  • 项目地址变更为：https://gitee.com/dromara/dante-cloud
  • 主工程所有模块名称，使用最新名称进行了修改。
  • 主工程所有代码所在的包，使用最新名称进行了修改。
  • Nacos 配置文件名称及相关配置项，使用最新名称修改。
  • 数据库初始化脚本默认数据，涉及项目名称的内容进行了修改。
• 其它更新
  • 修复 MySQL 数据初始化脚本错误
  • OkHttps 版本升级至 3.5.3
  • Tencentcloud-sdk-java-sms 版本升级至 3.1.559

友情提示

1. 因代码模块名和代码包名存在变更，直接更新代码会在 IDE 工具中产生冗余结构，可以直接删除，建议全新检出工程以彻底规避该问题。
2. 因  Nacos  配置文件名称存在变更，需要重新导入  Nacos  配置。

v2.7.2.1

• 主要更新

  • [修复] 用户账号登录超出错误次数被锁定以后，自动恢复账号状态代码使用错误参数导致恢复出错问题。fix: #I5J8QS
  • [修复] 系统页面长时间停留在登录页面，自定义 Session 过期，后端错误提示不友好问题。fix: #I5J9S8
  • [修复] 修改密码传递至后端加密数据无法正确解密，出现缓存反序列化错误问题。fix: #I5JEF3
  • [修复] 使用全名替换 dependencies dependencyManagement 配置中使用变量配置的 groupId，修复外部新建服务工程无法准确获取主工程生成的依赖包问题。
  • [删除] 删除 JPush 相关的信息推送和短信发送相关组件模块
  • [优化] 优化权限数据同步分发数据存储逻辑，将本地和远程缓存同时存储，修改为只在本地缓存存储。

• 依赖更新

  • JetCache 版本升级至 2.6.7
  • WxJava 版本升级至 4.3.8.B
  • Tencentcloud-sdk-java-sms 版本升级至 3.1.558

v2.7.2.0

• 主要更新

  • Spring Boot 版本升级至 2.7.2
  • Spring Boot Admin 版本升级至 2.7.3
  • Vite 版本升级至 3.0.2
  • 使用 JetCache 重构已有自定义 JPA 多级二级缓存代码，将系统中所有多级缓存统一为使用 JetCache。也为后续升级 JetCache 2.7.X，实现服务本地缓存自动同步更新功能做铺垫。
  • 新增极简 CMDB 配置管理服务及前端管理功能，用于管理应用系统、服务器、数据库等基础配置信息。

• 其它更新

  • [修复] 修复用户密码过期状态判断条件使用错误，fix #I5I7ZZ
  • [修复] 修复后端配置前端菜单角色信息，前端工程读取错误，导致菜单无法过滤问题。
  • [新增] 优化数据库初始化脚本，增加菜单默认初始化数据以及测试用切换账号数据。
  • [新增] 增加后端菜单数据节点排序功能，可通过 Ranking 字段进行配置。
  • [优化] 优化服务间权限数据同步代码逻辑，删除不合理代码、简化同步实现逻辑。
  • [删除] 删除 cache-sdk-layer 和 cache-layer-spring-boot-starter 两个模块

• 依赖更新

  • redisson 版本升级至 3.17.5
  • tencentcloud-sdk-java-sms 版本升级至 3.1.557
  • alipay-sdk-java 版本升级至 4.31.72.ALL
  • com.baidu.aip 版本升级至 4.16.10

v2.7.1.3

• 主要更新

  • [新增] 增加菜单管理功能，支持后端数据动态转换为前端菜单，根据用户角色动态切换菜单
  • [新增] 增加基于 Spring Authorization Server 的 Token 信息扩展，客户端在获取 Token 时就可以同时获取用户的相关信息，方便客户端区分用户身份信息，减少重复请求。使用前后端数据加密，进一步保护敏感信息。
  • [升级] 前端工程 Vite 版本升级至 3.0.1

• 其它更新

  • [优化] 优化系统用户登录合规性记录代码，去除重复性逻辑及部分硬代码
  • [优化] 优化 ServiceContext 代码逻辑，增加统一的 HTTP 地址 Protocol 头处理机制，实现代码中 HTTP 或 HTTPS 协议头的统一配置和修改
  • [修复] 修复 Swagger 认证功能不生效无法在 Swagger 中进行测试问题，以及多环境下 Swagger 是否开启控制失效问题。
  • [修复] 修复单体版 Swagger 多是否开启控制失效问题， 以及 Swagger 界面中自动生成的接口地址错误问题。
  • [升级] 升级 Antisamy XSS 拦截分析配置文件版本

• 依赖更新

  • antisamy 版本升级至 1.7.0
  • minio 版本升级至 8.4.3
  • jetcache 版本升级 2.6.6
  • dysmsapi20170525 版本升级至 2.0.16
  • tencentcloud-sdk-java 版本升级 3.1.552
  • alipay-sdk-java 版本升级至 4.31.64.ALL

v2.7.1.2

• 主要更新：

  • Spring Boot Admin 版本升级至 2.7.2
  • 增加应用安全合规检查相关支持功能
    1. [新增] 用户账号过期时间和用户密码过期时间。优化系统用户是否可用、是否锁定以及账号过期时间和密码过期的状态控制
    2. [新增] 在同一类型终端下，允许同一账号重复登录限制。可通过配置修改默认允许重复登录数值，默认值为 1.
    3. [新增] 用户登录错误次数限制，超过最大错误次数系统将自动锁定该用户账号（前提是系统中已存在的用户）。提供自动解锁功能和管理员解锁支持。
    4. [新增] 新增用户登入、登出系统记录功能。包含，登录账号、时间、IP、使用的终端类型、浏览器类型、操作系统等相关信息。
  • 增加基于 Minio 对象存储的大文件分片上传功能。

• 其它更新

  • [优化] 进一步优化 Spring Authorization Server 认证过程错误体系与 Spring Security 登录错误体系的融合。解决 Spring Authorization Server 认证错误信息无法触发 Spring Security 自身特性问题。
  • [优化] 优化 Spring Authorization Server 错误提示信息，让登录错误反馈信息更加友好和准确。
  • [优化] 自定义认证模式代码，进行详细的用户信息校验，用户登录相关错误抛出机制和逻辑。在登录出错的情况下，抛出合理的 OAuth2 认证错误信息，便于区分错误类型以及进行应用安全合规性校验。
  • [优化] 优化基于 JPA 的自定义 Spring Authorization Server 数据访问相关代码，优化 OAuth2AuthorizationService 删除逻辑处理，增加过期 Token 清理逻辑。
  • [优化] 优化基于 JPA 的自定义 Spring Authorization Server 数据访问相关代码，补充部分常用字段索引的自动创建配置，提升数据查询效率。
  • [优化] 优化涉及 @RequestBody 注解接口的前后端数据加密加密传输的解密逻辑，除了维持原有整个 JSON 加解密外，增加 JSON 属性遍历解密，以提升前后端数据加解密的灵活性。
  • [优化] 优化部分 starter 自动配置文件，改用 Spring Boot 最新的 org.springframework.boot.autoconfigure.AutoConfiguration.imports 配置文件
  • [新增] 新增 Spring Authorization Server 主要接口，是真正的退出接口，取代原有使用 Spring Authorization Server 默认提供的撤销 Token 接口。
  • [新增] 调用开放型接口前（无须鉴权的接口），新增对客户端的有效性的校验，以增强接口调用的安全性
  • [新增] 增加登录界面自定义 Session 检测，Session 未创建成功或后端无法正常连接，则禁止登录。
  • [新增] 因代码中多处使用基于多级缓存的计数逻辑，由此新增基于缓存的计数逻辑抽象类，方便此类功能代码的编写。
  • [新增] 前端设计接口或权限的功能，增加权限接口的排序查询支持。
  • [新增] 前端修改用户密码功能，密码复杂度校验。
  • [新增] 增加 Redis 事件监听配置，实现 Redis 过期数据的监听和逻辑处理。
  • [新增] 增加 ZonedDateTime 时间类型转换工具类，方便 Minio API 代码的使用。
  • [新增] 增加 Minio 对象存储容器化部署 Docker-compose 脚本
  • [修复] 涉及排序的接口，默认参数值设置错误问题。
  • [修复] 修复由于默认缓存时间设置过短，导致前后端数据加解密失效问题。修改为默认与客户端配置 accessToken 失效相同。

• 依赖更新：

  • WxJava 版本升级至 4.3.7.B
  • Dysmsapi20170525 版本升级至 2.0.15
  • Tencentcloud-sdk-java-sms 版本升级至 3.1.546
  • Alipay-sdk-java 版本升级至 4.31.48.ALL
  • Jpush-client 版本升级至 3.6.6
  • Jiguang-common 版本升级至 1.2.2

v2.7.1.1

• 新版前端发布

基于 Vue3、Vite2、Pinia、Quasar2、Typescript、Hooks 等最新技术栈，全新构建前端工程正式发布

新版前端特点：

1. 未使用任何流行开源模版，使用全新技术栈，完全纯"手写"全新前端工程。
2. 借鉴参考流行开源版本的使用和设计，新版前端界面风格和操作习惯尽量与当前流行方式统一。
3. 充份使用 Typescript 语言特性，解决大量类型校验问题，尽可能规避 "any" 式的 Typescript 编程语言使用方式。
4. 充份使用 Composition Api 和 Hooks 等 Vue3 框架新版特性进行代码编写。
5. 充份利用 Component、Hooks 以及 Typescript 面向对象等特性，抽取通用组件和代码，尽可能降低工程重复代码。
6. 对较多 Quasar 基础组件和应用功能组件进行封装，以方便代码的统一修改维护和开发使用。
7. 对生产模式下，对基于 Vite2 的工程打包进行深度性能优化。
8. 提供以 docker-compose 方式，对工程生产代码进行容器化打包和部署。

• 其它更新

  • [优化] 基于 commons-pool2, 将 Minio 对象存储的 MinioClient 代码进行池化，以提升与 Minio 服务端的交互效率。
  • [优化] 补充和优化 MinioProperties 对象池配置参数。多数配置默认参数，与 commons-pool2 包提供的默认值统一。
  • [优化] 重新梳理对象存储模块错误错误 Exception，将其融入平台整体错误体系，返回给前端更友好错误信息提示。
  • [重构] 重构 Minio Oss 操作基础 Service 代码，丰富 Minio 操作 Service 代码，涵盖大部分 Minio SDK 支持的 API。
  • [修复] 修复 Oss 模块组件代码包中，Minio 模块条件注解不生效，导致 Minio 包无法通过注解开启问题。

• 依赖更新

  • Hutool 版本升级至 5.8.4
  • Mybatis-plus-generator 版本升级至 3.53
  • Tencentcloud-sdk-java-sms 版本升级至 3.1.540
  • Com.baidu.aip 版本升级至 4.16.9
  • Aliyun-sdk-oss 版本升级至 3.15.1

v2.7.1.0

• 重要更新
  • Spring Boot 版本升级至 2.7.1
  • Spring Boot Admin 版本升级至 2.7.1
  • Skywalking Java Agent 版本升级至 8.11.0
• 其它更新
  • [新增] 增加通过范围代码查询应用范围接口
  • [新增] 增加自定义打包的 JDK 镜像 herodotus/oracle-jdk:8u331，彻底根除服务在 Docker 环境下由于使用 OpenJDK 版本不同的差异导致无法读取字体出错，以及打包成镜像过程中下载字体慢的问题。该镜像已经上传至 Docker Hub，可以直接下载使用。
  • [新增] 对几款常用的 OpenJDK 基础镜像进行了验证，在 Dockerfile 中，新增了适合使用的两个版本 JDK 基础镜像配置，放开注释即可选择使用。
  • [优化] 优化涉及字体读取的行为验证码和图形验证码代码，增强在不同系统和不同 Java 版本下的兼容性。
  • [修复] 调整 Skywalking Docker Compose 配置参数，解决 8.7.0-es7 以后版本 Skywalking Docker 无法正常启动问题。
  • [删除] 删除项目核心 dependencies 中，与新版本 spring-boot-dependencies 中重复的依赖及版本 pom 配置，尽量使用 spring-boot-dependencies 对项目大部分依赖版本进行管控，减少依赖的重复配置以及版本不兼容问题。
• 依赖更新
  • WxJava 版本升级至 4.3.6.B
  • mapstruct-processor 版本升级至 1.5.2.Final
  • mybatis-plus-boot-starter 版本升级至 3.5.2
  • tencentcloud-sdk-java 版本升级至 3.1.537
  • alipay-sdk-java 版本升级至 4.31.28.ALL
  • jpush-client 版本升级至 3.6.3

v2.7.0.60

• 重要更新
  • Spring Authorization Server 版本升级至 0.3.1
  • 系统使用 Java 版本降级兼容 Java 8，经验证目前本系统在 Java 8、11、17 环境下均可以正常稳定运行。
• 其它更新
  • [修复] 修复人员归属管理功能中，删除已配置人员归属会出现 Jackson 反序列化问题。
  • [优化] 优化单位树和部门树，树形数据组织代码，对不同类型的根节点数据，统一处理为系统定义标准根节点，便于前端组件使用和封装。
  • [优化] 优化社交登录接口相关代码，同时增加 @Inner 注解，解决该接口内部调用跳过权限验证问题。
  • [优化] 优化自定义 OAuth2 Security 权限元数据管理接口相关代码
  • [重构] 重构权限表达式枚举类代码，与系统已有枚举常量体系统一。调整该类所在包，便于前端将其常量使用。
  • [删除] Spring Security 5.7.0 版本以前，Spring Security WebAuthenticationDetails 类只支持 HttpServletRequest 做为参数，这导致无法在 Spring Security 自身的登录页面增加验证码等额外信息。因此，提取了 WebAuthenticationDetails 代码进行扩展，以支持登录验证码功能。随着 Spring Security 的版本升级至 5.7.1，该问题已经被修复，因此删除原有自行扩展代码。
• 依赖更新
  • OkHttp 版本升级至 4.10.0

v2.7.0.50

• 重要更新
  • Spring Boot Admin 版本升级至 2.7.0
• 主要更新
  • [新增] 新增读取全部角色和读取全部 Scope 接口，删除已有基于权限类别读取权限接口
  • [新增] 自定义 Validation 注解 EnumeratedValue，支持对指定枚举的 name 或 ordinal 值进行校验，提升接口的健壮性。
  • [新增] Spring Data JPA 分页查询数据排序支持。通过接口动态传递额外参数，实现分页数据的排序。
  • [修正] 修复幂等和防刷拦截器读取配置不正确问题。优先读取注解配置参数，如注解为设置参数值，则默认使用统一配置参数。
  • [优化] 优化 Security 工具类，使用 Spring Security 最新的获取 PasswordEncoder 工厂类重构密码创建方法和密码校验方法。
  • [优化] 优化幂等和防刷注解和配置的默认参数值，设置更合理的参数，解决幂等和防刷过于敏感问题。
• 依赖更新
  • docker-maven-plugin 版本升级至 0.40.1
  • maven-embedder 版本升级至 3.8.6
  • maven-compat 版本升级至 3.8.6
  • redisson 版本升级至 3.17.4
  • minio 版本升级至 8.4.2
  • hutool 版本升级至 5.8.3
  • weixin-java-sdk 版本升级至 4.3.5.B
  • tencentcloud-sdk-java 版本升级至 3.1.530
  • qiniu-java-sdk 版本升级至 7.11.0

v2.7.0.40

• 主要更新：
  • [修复] 修改幂等防护注解默认配置，解决行为验证码验证过程中，频繁出现幂等错误提示问题。
  • [修复] 修正因统一 Jackson ObjectMapper 配置，产生时间类型反序列化不正确，导致 Spring Authorization Server 认证相关操作抛错问题。
  • [优化] 优化 Protect 包内相关 Exception 及配置，将其融入到系统的错误体系中，让返回错误信息更加直观也更加人性化。
• 依赖更新
  • Docker-maven-plugin 版本升级至 0.40.0
  • Mapstruct-processor 版本升级至 1.5.1.Final
  • WxJava 版本升级至 4.3.5.B
  • Mybatis-plus-boot-starter 版本升级至 3.5.2
  • Tencentcloud-sdk-java 版本升级至 3.1.526
  • Alipay-sdk-java 版本升级至 4.31.7.ALL

v2.7.0.30

• 主要更新
  • [新增] 统一 OkHttp 、HttpClient 自定义配置，实现 OkHttp 、HttpClient 与 RestTemplate 、Openfeign 整合。统一使用 Feign 配置参数，对 OkHttp 、HttpClient 进行参数设定。可通过配置参数，策略化设置使用 OkHttp 还是 HttpClient 作为 RestTemplate 、Openfeign 的基础 HttpClient。
  • [新增] 增加 OkHttp 、HttpClient 平滑退出机制，服务退出前自动销毁已经创建的 Client。将 OkHttp 错误响应与已有错误体系整合，使用统一响应结构返回数据。
  • [新增] 重新定义 Feign 配置，实现 Feign 调用日志输出。统一 Feign 错误解码器，并与已有错误体系整合。
  • [新增] 重构 Feign 与 Sentinel 整合代码，补充 Feign 自动降级处理。增加统一的 fallback 处理机制，无须再进行 FeignClient Fallback 配置。
  • [新增] 增加 @Inner 注解，实现 Feign 内部接口调用无须进行权限验证，同时 Gateway 以外调用仍需权限验证的机制。无须在 Feign 接口中传递额外参数，注意：该注解只能在 @FeignClient 定义类中使用。
  • [修复] 调整 WebMvc 配置，解决原有配置方式下自定义 interceptor 不生效，导致防刷、前后端数据传输加解密不工作问题。
  • [修复] Dockerfile 和 Docker Compose 配置文件错误。升级依赖的 JDK 版本，去除原有字体下载配置。
  • [优化] 调整 JacksonConfiguration 代码所在的包，让代码归类放置更合理。解决自定义 JacksonConfiguraiton 注入顺序不当而不生效问题。
  • [优化] 用更优的办法，解决在 JDK 17 环境下，因 okhttp 和 okio 版本不匹配，而导致的运行错误问题。
  • [优化] 修改 Nacos 配置，去除上一版本为临时解决 JDK 17 下 Okhttp 兼容问题增加的配置。
  • [优化] 使用 Spring Boot 2.7.0 新的自动配置注册文件，替换 facility-spring-boot-starter、web-spring-boot-starter 等模块 spring.factories 自动配置文件
  • [文档] 补充部分组件简要说明 Readme，帮助快速了解组件用途。
• 依赖升级
  • Redisson 版本升级至 3.17.3
  • SpringDoc 版本升级至 1.6.9
  • Hutool 版本升级 5.8.2
  • Qiniu-java-sdk 版本升级至 7.10.4
  • Alipay-sdk-java 版本升级至 4.27.1.ALL

v2.7.0.20

• 重要更新
  • Dante Cloud 版本使用 JDK 从 8 升级至 17 (注意：现有版本不在兼容 JDK 8)
• 主要更新
  • Spring Cloud 版本升级至 2021.0.3
  • Spring Authorization Server 版本升级至 0.3.0
• 其它更新
  • 根据 Spring Authorization Server 0.3.0 代码的变化，修改和调整现有系统代码
  • 为支持 JDK 17，同时解决老旧依赖包安全漏洞问题，临时删除现有 baidu 短信模块
  • 升级 Kryo 版本至 5.3.0，增加自定义拓展代码，解决 Kryo 现有版本与 JDK 17 不兼容问题而导致的 Jetcache 无法使用问题。
  • 升级 Xnio 版本，解决 Undertow 在 JDK 17 环境下运行，抛出 Could not initialize class org.xnio.channels.Channels 错误，导致服务无法运行问题。
  • 修复 docker-compose 配置错误。
  • 修复现有工程中残留的 FastJson 使用代码。
• 依赖更新
  • JetCache 版本升级至 2.6.5
  • Tencentcloud-sdk-java 版本升级至 3.1.516
• 额外说明
  • 因 Spring Authorization Server 0.3.0 默认 JDK 已升级至 11，在 JDK 8 环境下编译出错，已无法兼容 JDK 8，所以考虑升级系统使用 JDK 版本。
  • 2022 年 11 月，Spring Boot 3 将会发布，最低版本要求 JDK 17。因此，直接将 JDK 版本升级至 17，为升级至 Spring Boot 3 提前做铺垫准备。

v2.7.0.10

• 主要更新
  • Fastjson 版本升级至 1.2.83。消除 Fastjson 反序列化任意代码执行漏洞。
  • 使用 Jackson 全面替换工程中涉及的 Fastjson 代码。保留工程 Fastjson 依赖，用于统一控制其它第三方依赖包中依赖的 Fastjson 版本。
  • 合并原有 assistant-sdk-json 包至 assistant-core。新增 Gson 通用工具类。
  • 重构缓存相关模块，将 redis 和 caffeine 模块独立出来。使用标准化方式重新配置 redis，解决早期在 jar 包模式下，自定义 Redis 配置不生效问题
  • 使用 Spring Boot 2.7.0 新的自动配置注册文件，调整部分 starter 自动注入配置文件
  • 增加基于 Redis 的 Spring Cloud Session 共享基础配置。同时支持 Servlet 和 Webflux
  • 去除重复定义的 JPA 实体自定义 KEY Generator 名称
• 其它更新
  • Redisson 版本升级 3.17.2
  • Logstash Logback Encoder 版本升级至 7.2
  • WxJava 版本升级至 4.3.4.B
  • MyBatis 版本升级至 3.5.10
  • Tencentcloud-sdk-java 版本升级 3.1.514
  • Qiniu-java-sdk 版本升级至 7.10.3
  • Alipay-sdk-java 版本升级至 4.23.26.ALL
  • com.baidu.aip 版本升级至 4.16.8

v2.7.0.0

• 主要更新
  • Spring Boot 版本升级至 2.7.0
• 其它更新
  • 修正新版 Spring Boot 下 applicationContext 获取 Bean RequestMappingHandlerMapping 出错问题。
  • 修正权限数据通过消息队列传递， Jackson 反序列化出错问题。
  • 修正新版 Spring Boot 下，OkHttp 与已有 Spring Cloud 版本不兼容，导致服务无法启动问题。
  • 将 RestTemplate 底层客户端组件，临时由 OkHttp 改为 HttpClient，以规避 Okhttp 与 Spring Cloud 不兼容问题
• 依赖更新
  • Maven Invoker 版本升级至 3.2.0
  • Minio 版本升级至 8.4.1
  • Hutool 版本升级至 5.8.1
  • Okhttps 版本升级至 3.5.2
  • WxJava 版本升级至 4.3.3.B
  • Alipay-sdk-java 版本升级至 4.23.21.ALL

v2.7.0.RC1

• 主要更新
  • Spring Boot Admin 版本升级至 2.6.7
  • Nacos 版本更新至 2.1.0, 同步更新 Nacos Docker 版本，新增 Nacos 2.1.0 SQL 脚本。(提示：该版本有数据结构变化，建议备份已有配置信息，重新导入数据库脚本)
  • 增加 Spring Authorization Server 自定义密码认证模式前后端数据加密传输。
  • 增加国密算法 SM2 SM4，采用数字信封技术融合国密 SM2 SM4 算法，实现前后端数据加密传输。保留基于 RSA 和 AES 的前后端加密传输方式，可通过配置选择切换。
  • 整合 rest-sdk-crypto、rest-sdk-secure、assistant-sdk-secure 代码包，形成统一的防护组件，包含前后端数据加密、接口幂等、防刷、Xss 和 SQL 注入防护，以及国密 SM2、SM4、RSA、AES 等加密逻辑。
• 其它更新
  • Hutool 版本升级至 5.8.0
  • Bce-java-sdk 版本升级至 0.10.208
  • Minio 版本升级至 8.4.0
  • Alipay-sdk-java 版本升级至 4.23.0.ALL

v2.7.0.Beta4

• 主要更新
  • [升级] Spring Authorization Server 版本升级至 0.2.3 版本
  • [升级] Spring Boot 版本升级至 2.6.6
  • [新增] 基于 Spring Authorization Server 0.2.3 最新代码调用方式，重构自定义 OAuth2 密码模式
  • [新增] 对 OAuth2 OIDC 认证模式的支持，补充前端 OIDC 认证相关配置操作
  • [新增] OAuth2 OIDC 认证方式下，对应的 /userinfo 接口调用支持 和 客户端注册支持
  • [新增] OAuth2 Authorization Code PKCE 认证模式支持
  • [新增] OAuth2 Client Credentials 模式下，提供 Refresh Token。
  • [新增] OAuth2 Client Credentials 模式下，支持使用 Scope 权限对接口进行验证。
  • [新增] 在已有的 oauth2-sdk-authorization-server 模块下，增加客户端 Scope 的权限配置功能，并与已有的用户权限体系解耦
  • [新增] 自定义 Social Credentials 认证模式，支持手机短信验证码、微信小程序、第三方应用登录
  • [修复] 在 OAuth2 OIDC 认证方式下，/userinfo 接口调用始终为 401 问题。
  • [修复] 自定义 Spring Authorization Server JPA 存储模式参数丢失，遗漏 Scope 设置，导致 /userinfo 调用失败问题
  • [修复] No AuthenticationProvider found for UsernamePasswordAuthenticationToken 问题导致的用户名无法登录问题
  • [修复] 服务启动过程中，由于异步操作与事务操作冲突，导致的 JetCache 数据存储产生并发异常
  • [修复] 改进 @Async 注解调用代码，解决由 jdk 自动代理与 CGlib 代理两种代理方式的区别造成代码抛出异常
  • [修复] 改进 OAuth2 基础操作代码，解决 Spring Authorization Server 部分配置不能设置为空值的问题
  • [修复] Spring Cloud Bus 进行远程事件发布时，所有事件监听代码均会接收数据，无法根据服务 Destination 定向处理的问题。
  • [优化] 优化 SecurityGlobalExceptionHandler，支持 OIDC 场景下对错误内容的拦截，并将其融合进整体错误体系
  • [优化] EndpointProperties 配置，区分系统涉及的 url 以及 endpoint，以便支持更多用途
  • [优化] 重构并抽象出策略事件 Event，以规范化大量使用的混合本地时间和远程事件的各类操作。
  • [优化] 规范化所有 Enum 类，使用统一方式为前端提供常量
  • [优化] 优化 OAuth2 应用管理前后端交互相关代码及 OpenApi 文档说明
• 其它更新
  • Spring boot admin 版本升级至 2.6.4
  • Redisson 版本升级至 3.17.0
  • Antisamy 版本升级至 1.6.6
  • Fastjson 版本升级至 1.2.80
  • Okhttps 版本升级至 3.4.6
  • Bce-java-sdk 版本升级至 0.10.202
  • Alipay-sdk-java 版本升级至 4.22.75.ALL
  • Qiniu-java-sdk 版本升级至 7.9.5
  • Logback 版本升级至 1.2.11
• 尝鲜注意事项
  1. 建议新建目录、单独检出 Dante Cloud 2.7.0 分支代码，以防对现有代码产生影响。
  2. 数据表结构以及 Nacos 存在较大变化，建议重新建库、重新导入 Nacos 配置。
  3. 支持 MySQL 数据库，但是尚未进行充份的验证和测试，为规避不必要的问题，建议直接使用 PostgreSQL 数据库。
  4. Herodotus Engine 是独立的、可编译的、组件库式的工程，具体使用需要在其它 Spring Boot 工程中引入相关的组件模块。独立出的各个模块，已经同步至 Maven 中央仓库，检出 Dante Cloud 2.7.0 分支代码既可以直接使用。当然，也可以先检出 Herodotus Engine 工程，编译后再进行 Dante Cloud 项目的使用。
  5. 想要研究、学习、了解已有的模块代码，可以访问 Herodotus Engine 代码库，地址：https://gitee.com/herodotus/herodotus-engine

v2.7.0.Beta3

• 重大更新

  1. 全面拥抱 Spring Authorization Server。基于 Spring Authorization Server 重新改版，替换即将停止维护的 Spring Security OAuth2。再也不用担心 Spring Security OAuth2 停止维护了。
  2. 基于 Spring Data JPA，重新构建 Spring Authorization Server 基础数据存储代码。替代原有 JDBC 数据访问方式，破除 Spring Authorization Server 原有数据存储局限，扩展为更符合实际应用的方式。配合自定义多级缓存加持，认证过程更加顺滑。
  3. 基于 Spring Authorization Server，在 OAuth 2.1 规范基础之上，增加自定义“密码”认证模式，以兼容现有基于 OAuth 2 规范的、前后端分离的应用可以平滑使用。
  4. 基于 Spring Authorization Server 新的数据存储结构，重新定义应用管理、客户端管理功能，同步修改前后端代码，管理更加便捷。
  5. 完全遵照 Spring Security 5 以及 Spring Authorization Server 的代码规范，进行 OAuth2 认证服务器核心代码的开发。
  6. 除了支持 Spring Authorization Server 的标准的 Token 加密校验方式外，还了增加支持自定义证书的 Token 加密方式，可通过配置动态修改。
  7. 重新梳理并调整优化已有配置参数，让工程配置参数更加清晰，层级更加合理。同时，拆分原有使用内部类定义的配置参数，进一步由配置参数导致的代码耦合。
  8. 同步优化 Nacos 配置内容，采用 Spring Authorization Server 标准 Token 校验方式，新服务增加无须再增加配置文件和进行 Client 配置。
  9. 重新梳理本微服务架构内的错误体系及相关代码，已有的 Exception 类放入更合理的保重，无须再经过修改通用基础包中代码，即可便捷的将新的 Exception 融入到系统的错误体系中。同时，仍旧支持自定义错误码以及人机交互友好的自定义错误提示。
  10. 对已有代码进行了深度的“庖丁解牛”。严格遵照“单一职责”原则，根据各个组件的职责以及用途，拆解细化为多个各自独立组件模块，在最大程度上降低代码间的耦合。降低工程代码编译耗时，改进 CICD 效率，提升代码可维护性。
  11. 除已有的组件模块外，对现有工程代码分包也进一步调整，分包和逻辑更加清晰。

• 其它更新

  • 优化接口权限鉴权逻辑，解决通配符类型权限与全路径权限冲突或重复的问题，实现重复权限剔除并以最大化匹配方式进行权限匹配逻辑。
  • 由于 Spring Authorization Server 机制和模式的变化，原有团队管理功能已不符合实际，相关功能已删除。
  • 前端部分功能配合后端功能变化进行同步修改和改进。
  • 原有 Herodotus Engine 工程中的模块，根据实际代码变更。代码包以及代码进行了一定的优化和整合。
  • 核心依赖 dependencies 采用参数方式，统一定义版本号方便其它依赖工程覆盖和修改版本号。
  • 改进错误信息展示，同时支持 Mvc 和 Json 两种方式，通过浏览器操作的 Mvc 方式错误也可以通过界面展示了。

• 尝鲜注意事项

  1. 建议新建目录、单独检出 Dante Cloud 2.7.0 分支代码，以防对现有代码产生影响。
  2. 数据表结构以及 Nacos 存在较大变化，建议重新建库、重新导入 Nacos 配置。
  3. 支持 MySQL 数据库，但是尚未进行充份的验证和测试，为规避不必要的问题，建议直接使用 PostgreSQL 数据库。
  4. Herodotus Engine 是独立的、可编译的、组件库式的工程，具体使用需要在其它 Spring Boot 工程中引入相关的组件模块。独立出的各个模块，已经同步至 Maven 中央仓库，检出 Dante Cloud 2.7.0 分支代码既可以直接使用。当然，也可以先检出 Herodotus Engine 工程，编译后再进行 Dante Cloud 项目的使用。
  5. 想要研究、学习、了解已有的模块代码，可以访问 Herodotus Engine 代码库，地址：https://gitee.com/herodotus/herodotus-engine

友情提示：

本次代码发布，为尝鲜预览版，请结合自己的实际需求，谨慎选择使用！

Spring Authorization Server 也在不断的改进中，0.2.3 和 0.2.2 代码就有较大差异，因此暂时不要将该版本用于生产，随着 Spring Authorization Server 升级，代码还会进行较大的修改。

v2.7.0.Beta2

1. 更正工程 Readme 文档表述错误内容。
2. 优化自定义 Hibernate Dialect，增加 PostgreSQL 环境下对 CLOB 和 BLOB 数据类型的统一支持。为 Spring Authorization Server 的使用奠定基础
3. 完善大量 Herodotus Engine 代码中的注释内容，解决代码编译生成 Javadoc 显示大量告警信息问题。
4. 由于使用组件库的方式，源代码包和 Javadoc 包均已生成。已有微服务工程无须再进行源代码的编译，因此去掉 Dante Cloud 主工程源代码编译配置和相关依赖。

v2.7.0.Beta1

• 重要变更

  • 将现有 Dante Cloud 微服务架构，进行了深度的“庖丁解牛”。将完整的微服务架构，根据各个组件的职责以及用途，拆解细化为多个各自独立组件模块，在最大程度上降低代码间的耦合。并将组件模块单独提取为一个独立的工程项目。
  • 已有 Dante Cloud 微服务架构，根据新的模块化代码结构，进行了重构。

• 升级目的

  • 2021 年 11 月 8 日 Spring 官方已经强烈建议使用 Spring Authorization Server 替换已经过时的 Spring Security OAuth2.0。距离 Spring Security OAuth2.0 结束生命周期还有小半年的时间，所以准备用 Spring Authorization Server 对已有的 Dante Cloud 微服务架构进行升级
  • Dante Cloud 微服务架构，一直遵循“高内聚、低耦合”的原则，在开发和维护的过程中不断优化已有代码，尽一切可能降低代码的耦合性。但是，毕竟所有的代码都堆积在同一个工程中，代码间的过度依赖和互相耦合还是较为严重。这为 Spring Authorization Server 替换 Spring Security OAuth2.0 带来了较大的阻力和难度。
  • 为了进一步降低代码与代码间、模块与模块间的耦合度，进行了本次版本更新，并衍生了 Herodotus Engine 工程。
  • 同时，本次版本迭代，也是为了后期升级使用 Spring Boot 3.X 和 JDK 17，做先期主备。

• 新模式特点

  1. 严格遵照“单一职责”原则，进行各个模块的划分和代码拆解。
  2. 严格遵循 Spring Boot 编码规则和命名规则。
  3. 大多数模块均支持 @EnableXXX 注解 和 starter，不仅提升了模块使用的便捷性，同时在开发使用过程中，让 Spring Bean 的注入顺序更加可控和便于理解。
  4. 借鉴 Spring Boot 模块化设计思想，通过接口化编程、策略化 Bean 注入 以及丰富的自定义 @ConditionalXXX 注解，让模块的添加和使用更加灵活便捷。
  5. 各模块既可以综合在一起使用，也可以在其它 Spring Boot 工程中独立使用

• 新模式优势

  1. 虽然模块看似很多，但是每个模块职责单一、代码清晰，更有利于聚焦和定位问题。
  2. 通过对微服务架构的“庖丁解牛”，初学者不再需要在代码的海洋里“遨游”，通过针对性地了解各个模块，以点带面快速掌握微服务架构整体结构。
  3. 模块间的依赖极大的降低，想要替换为 Spring Authorization Server，影响到的代码和范围将会很小。该工程也是使用 Spring Authorization Server 的前序工作
  4. 每个模块均是最小化依赖第三包，规避依赖包过度依赖，特别是 starter 过多依赖，导致不可预知、难以调试、不好修改等问题。
  5. 降低微服务系统代码量，独立组件可提前编译并上传至 Maven 仓库，降低工程代码编译耗时，改进 CICD 效率。

• 尝鲜注意事项

  1. 建议新建目录、单独检出 Dante Cloud 2.7.0 分支代码，以防对现有代码产生影响。
  2. 独立出的各个模块，已经同步至 Maven 中央仓库，检出 Dante Cloud 2.7.0 分支代码既可以直接使用。当然，也可以先检出 Herodotus Engine 工程，编译后再进行 Dante Cloud 项目的使用。
  3. 想要研究、学习、了解已有的模块代码，可以访问 Herodotus Engine 代码库，地址：https://gitee.com/herodotus/herodotus-engine
  4. 如果之前已经使用、部署过 Dante Cloud 微服务系统，那么尝鲜使用 2.7.0.Beta1 版，无须修改和变更数据库。但是需要更新 Nacos 配置，具体变化可自行详细对比工程中 Nacos 配置文件。前端工程无须做任何修改，即可使用该版本后端系统。
  5. Herodotus Engine 是独立的、可编译的、组件库式的工程，具体使用需要在其它 Spring Boot 工程中引入相关的组件模块。

友情提示：
本次代码发布，为尝鲜预览版，请结合自己的实际需求，谨慎选择使用！

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.7
• 其它更新
  • [优化] 优化 Webjars 相关组件的依赖关系，规避通过 rest 模块引入过多无用的依赖
• 依赖更新
  • [升级] maven-gpg-plugin 版本升级至 3.1.0
  • [升级] commons-io 版本升级至 2.12.0
  • [升级] redisson 版本升级至 3.21.3
  • [升级] alipay-sdk-java 版本升级至 4.35.132.ALL
  • [升级] com.baidu.aip 版本升级至 4.16.16

v3.0.6.4

• 主要更新
  • [升级] Spring Authroization Server 版本升级至 1.1.0
  • [升级] Spring Security 版本升级至 6.1.0
  • [新增] 新增支持智能电视、IOT 设备等输入受限设备的 Device Flow 认证模式
• 其它更新
  • [新增] 新增 Device Flow 认证系统内置页面
  • [新增] 新增 IOT 产品、设备管理 SDK
  • [重构] 重构 Spring Authorization Server 授权确认页面，与内置认证页面统一风格。
  • [重构] 除特殊依赖外，将所有内置页面静态资源引用改为 Webjars 方式。
  • [重构] 所有内置页面均改用页面嵌入 Vue 方式重新实现
  • [优化] 优化客户端动态自动注册相关功能代码及配置方式
  • [优化] 优化数据库初始化脚本，增加 Spring Authorization Server 内置默认 Scope 数据及关联数据
• 依赖更新
  • [升级] fastjson2 版本升级至 2.0.32
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.756
  • [升级] aliyun-sdk-oss 版本升级至 3.16.3

v3.0.6.3

• 主要更新
  • [升级] Spring Boot Admin 版本升级至 3.0.4
  • [升级] Spring Cloud Tencent 版本升级至 1.11.4-2022.0.1
• 其它更新
  • [重构] 重构自定义实体转换 RegisteredClient 代码，抽取公共转换适配器，减少重复代码方便后续 SAS 属性变更统一修改。
  • [重构] 重构 OAuth2 Authentication 模块，缩减包名，明晰定位。
  • [重构] 重构 Spring Authorization Server 相关自定义配置类，根据相关模块职责与定位，重新梳理所有配置参数，并整合已有配置类，调整和精简配置参数，减少配置在各模块间交叉引用，提升和增强模块内聚性。
  • [重构] 合并 oauth2-sdk-compliance 模块至 oauth2-sdk-management。
  • [优化] 减少 Dante Cloud 统一 dependencies 中配置的镜像仓库配置，避免过多 matadata 信息引起的 maven 下载 混乱
• 依赖更新
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.754

v3.0.6.2

• 主要更新
  • [新增] 新增 Webjars 支持，将内置页面引用的 JavaScript 和 CSS 全部改为 Webjars 方式引入，同时删除不必要的静态资源降低生成 jar 大小
  • [新增] SQLite 数据库集成 JPA 和 p6spy 支持
  • [重构] 重构统一错误体系代码，统一使用 FeedbackFactory 管理自定义错误信息，降低自定义 Exception 手动输入错误代码产生错误类型与 HttpStatus 不一致或不配问题。
  • [重构] 重构后端 Spring Authorization Server 核心数据实体，补充新版本缺失参数及字段
  • [重构] 抽取 Spring Authorization Server 通用工具代码，以支持更多认证模式。
  • [重构] 使用 Thymeleaf 模版统一内置页面布局，统一设备认证页面，提升页面代码易维护性。
  • [重构] 重新配置并统一 maven repositories 和 pluginRepositories。以 dante-engine dependencies 为核心，删除其它工程中，重复和冲突的配置。
  • [修复] 修复单体版 Swagger 参数层级配置错误，导致 SpringDoc Authorize 按钮不显示问题
  • [修复] 修复前端代码与后端不匹配以及字段参数缺失问题
  • [修复] 优化前端 OAuth2 应用管理功能，修复分页面内容显示错误问题。
  • [修复] 修改 Spring Authorization Server 默认的 SessionRepository 配置。解决使用 Spring Session 配置 SessionRepository 导致设备认证流程错误问题
• 依赖更新
  • [升级] mapstruct-processor 版本升级至 1.5.5.Final
  • [升级] maven-gpg-plugin 版本升级至 3.1.0
  • [升级] redisson 版本升级至 3.21.1
  • [升级] fastjson2 版本升级至 2.0.31
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.752
  • [升级] alipay-sdk-java 版本升级至 4.35.126.ALL

v3.0.6.1

• 主要更新
  • [升级] Spring Cloud Alibaba 版本升级至 2022.0.0.0-RC2
  • [升级] Spring Cloud Tencent 版本升级至 1.11.2-2022.0.1
  • [升级] Spring Boot Admin 版本升级至 3.0.3
  • [升级] Debezium 版本及相关基础设施版本升级至 2.2
  • [重构] 重构 Jackson 全局配置以及相关自定义代码
    1. 不再使用 @Primary ObjectMapper Bean 的方式全局配置 Jackson。
    2. 改用更灵活的、支持扩展的 Customizer 方式全局配置 Jackson。
    3. 同时兼顾全局配置、yaml 配置和自定义扩展，支持模块代码独立设置 Jackson 参数。
    4. 解决原有配置方式，只能通过修改源代码进行配置变更，无法自定义扩展问题。
    5. 解决原有配置方式，导致 yaml 配置失效、Spring Boot Jackson 默认 Bean 不注入等问题。
• 其它更新
  • [重构] Jackson XSS 防护代码迁移至 rest-sdk-protect 模块，降低 XSS 相关代码耦合性。
  • [重构] 部分重复代码、类似代码提取为公共方法或类
• 依赖更新
  • [升级] redisson 版本升级至 3.21.0
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.748

v3.0.6.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.6
  • [升级] Spring Security 版本升级至 6.1.0-RC1
  • [升级] Spring Authorization Server 版本升级至 1.1.0-RC1
• 其它更新
  • [漏洞] 修复 Snakeyaml (CVE-2022-1471) 存在反序列化漏洞 和 (CVE-2022-41854) 存在缓冲区溢出漏洞
  • [新增] 新增服务优雅停机支持
  • [新增] 新增 Nacos Server Postgresql 数据源支持插件及数据库初始化脚本
  • [修复] 修复 Access Token Scope 设置不正确导致 OAuth2 Client 使用授权码模式登录出错问题。
  • [修复] 修复组件模块编译错误
  • [修复] 修复自定义社交登录模式中，微信小程序参数获取不到错误。
  • [优化] Security 相关代码适配 Spring Security 最新用法。
  • [优化] 使用最新版 Bpmn-js、Diagram-js 内部 Typescript 定义替换自定义 Typescript 定义，并优化重构相关代码以适配最新定义
  • [重构] 采用页面嵌入 Vue 方式，重构授权页面。同时兼容 Device Authorization 授权页面
• 依赖更新
  • [升级] snakeyaml 版本升级至 2.0.
  • [升级] spring-security-cas 版本升级至 5.8.3
  • [升级] fastjson2 版本升级至 2.0.29
  • [升级] wxjava 版本升级至 4.5.0
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.743
  • [升级] alipay-sdk-java 版本升级至 4.35.110.ALL

v3.0.5.5

• 主要更新
  • [升级] Spring Cloud Tencent 版本升级至 1.11.1-2022.0.1
  • [升级] Spring Authorization Server 版本升级至 1.1.0-RC1
  • [升级] Spring Security 版本升级至 6.1.0-RC1
  • [升级] Camunda 版本升级至 7.19.0，同步更新数据库脚本
  • [升级] Skywalking Agent 版本升级至 8.15.0
  • [升级] Antisamy 版本升级至 1.7.3，同步升级 XSS 共计防护策略配置文件
• 其它更新
  • [重构] 重构各个模块 Constants 常量，清除无用代码，让各个常量归属更合理、命名更统一规范。
  • [重构] 重构 Minio 核心服务代码
  • [优化] 优化 Spring Authorization Server JPA 存储相关代码
  • [优化] 优化 Docker Compose 脚本
  • [修复] 修复针对 “text/html” 头的统一错误信息页面不显示问题
  • [删除] 删除重复放置的静态错误页面代码
• 依赖更新
  • [升级] antisamy 版本升级至 1.7.3
  • [升级] bcprov-jdk15to18 版本升级至 1.73
  • [升级] fastjson2 版本升级至 2.0.28
  • [升级] hutool 版本升级至 5.8.18
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.737
  • [升级] alipay-sdk-java 版本升级至 4.35.107.ALL
• 升级说明
  • 因仓库提交文件大小限制，所以本次发布不在上传 Skywalking Agent 相关 Jar 包，有需要请自行下载。
  • Camunda 7.19.0 尚未适配 Spring Boot 3，还无法正常使用，当前仅做依赖升级，

v3.0.5.4

• 主要更新
  • [升级] Nacos 版本升级至 2.2.2
• 其它更新
  • [修复] 收 DeviceController 类的 success()方法影响，导致授权码模式页面跳转错误问题。fix: #I6US82 (ISSUED by 大叔丨小巷)

v3.0.5.3

• 主要更新
  • [新增] 优化简单数据审计内容，新增实时数据审计、数据的变更记录、查看特定历史数据等数据审计功能
• 其它更新
  • [修复] 单位删除时增加参数接收设定 (PR by 未来)
  • [新增] 新增 MongoDB 基础 Entity、Repository、Service、Controller 和 MybatisPlus 基础 Controller，方便业务接口代码编写。
  • [优化] 设备认证授权模式激活页面调整
• 依赖升级
  • [升级] fastjson2 版本升级至 2.0.27
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.731
  • [升级] qiniu-java-sdk 版本升级至 7.13.0
  • [升级] alipay-sdk-java 版本升级至 4.35.101.ALL
  • [升级] aliyun-sdk-oss 版本升级至 3.16.2
  • [升级] xnio 版本升级至 3.8.9.Final

v3.0.5.2

• 主要更新
  • [升级] Spring Cloud Tencent 版本升级至 1.10.3-2022.0.1
• 其它更新
  • [修复] 修复数据库初始化数据 sql 脚本错误
  • [修复] 修复多租户数据源租户 ID 异步校验不生效问题
  • [修复] 修复前端应用新建多租户页面跳转错误问题
  • [优化] 优化数据自动初始化脚本放置位置，与新版本代码创建数据表需要启动两个服务机制进行统一。
• 依赖更新
  • [升级] springdoc 版本升级至 2.1.0
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.726
  • [升级] alipay-sdk-java 版本升级至 4.35.92.ALL

v3.0.5.1

• 主要更新
  • [升级] Spring Cloud 版本升级至 2022.0.2
  • [重构] 重构多租户功能，优化代码实现
    1. 多租户代码提取为单独代码模块，支持独立数据库(Database)、共享数据库(Schema)、共享数据表(Discriminator) 三种模式
    2. 默认开启共享数据表(Discriminator)模式, 取消所有表默认添加 TenantId 字段方式，改为按需添加以规避不必要的设计混乱
    3. 优化共享数据库(Schema)模式数据源切换逻辑，与独立数据库(Database)分离实现，避免冲突。
    4. 增加多租户数据源管理功能，多租户数据源从配置文件配置方式变更为通过数据表进行管理。
    5. 优化多租户数据库连接池、数据库事务支持。
• 其它更新
  • [新增] 新增前端工程 Authorization Code + PKCE 支持工具代码。
  • [新增] 增加 Spring 默认仓库，解决未使用腾讯镜像仓库无法下载 snapshot 或 milestone 版本问题。(PR by tao)
  • [优化] 删除 @herodotus/plugins 模块，将其代码移动到主工程。解决基础样式编译后过大以及编译新版本 quasar 问题出错。
  • [重构] 删除 data-sdk-p6spy 模块，将相关代码合并至 data-sdk-jpa 模块。
• 依赖更新
  • [升级] redisson 版本升级至 3.20.1
  • [升级] hutool 版本升级至 5.8.16
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.724
  • [升级] alipay-sdk-java 版本升级至 4.35.87.ALL

v3.0.5.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.5
  • [升级] Spring Boot Admin 版本升级至 3.0.2
  • [升级] Spring Cloud Tencent 版本升级至 1.10.2-2022.0.1
  • [升级] Spring Authorization Server 版本升级至 1.1.0-M2
  • [升级] Spring Security 版本升级至 6.1.0-M2
  • [升级] Nacos 版本升级至 2.2.1
  • [漏洞] 修复 Spring DoS 安全漏洞 (CVE-2023-20861)
• 其它更新
  • [修复] 修复授权码模式登录页面在最新版本 Spring Authorization Server 下被拦截问题
  • [修复] 优化前端 Vite 生产模式下 chunk 打包策略，解决 chunk 不合理设置，产生编译后的代码运行异常，导致前端页面无法正常显示问题。
  • [修复] 修复 docker-compose 脚本中，最新版本 Nacos 缺少新增默认环境变量，导致 Nacos 镜像无法正常启动错误。fix：#I6OMKH (ISSUED by 乌拉松)
  • [修复] 修复 mysql 数据库初始化脚本缺少 sys_user 数据问题。fix：#I6PNHB (ISSUED by ustcck)
  • [优化] Polaris 配置添加注册中心地址,docker 环境变量适配 (PR by 我问这瓜保熟吗)
  • [优化] spring cloud alibaba 相关配置增加适配 docker 环境变量配置
  • [新增] 支持字段级多租户模式
• 依赖更新
  • [升级] maven-embedder 版本升级至 3.9.1
  • [升级] maven-compat 版本升级至 3.9.1
  • [升级] fastjson2 版本升级至 2.0.26
  • [升级] mybatis 版本升级至 3.5.13
  • [升级] tencentcloud-sdk-java 版本升级至 3.1.720
  • [升级] alipay-sdk-java 版本升级至 4.35.83.ALL

v3.0.4.2

• 主要更新
  • [升级] SpringDoc 版本升级至 2.0.4

v3.0.4.1

• 主要更新
  • [改版] 基于 SAS 的动态接口权限全新改版
    • 不再直接使用接口作为权限数据，提取接口数据单独管理，额外增加权限层，支持同一权限配置多个接口。
    • 用户权限 和 OAuth2 Scope 权限，均已支持同一权限配置多个接口。提升权限配置和使用的便捷性，同时解决以接口作为权限导致 Token 过大过长问题。
    • 全面支持 Ant 风格 REST 接口转权限数据校验，支持静态配置权限与动态权限重叠冲突检查，包括通配符及占位符形式接口重叠冲突检查。
    • 权限重叠冲突检查会自动选取最大匹配规则作为权限校验元数据。例如：静态权限 /message/** 和动态权限 /message/send 重叠，会自动选取 /message/** 作为权限校验元数据。
    • 无须重启服务、修改代码，支持在系统后台动态修改某个接口的表达式权限，提升接口权限设置的便捷性和灵活性。
    • 结合最新版本 Spring Authorization Server 和 Spring Security，重新梳理当前支持动态表达式权限，去除冗余、重复以及不再支持的表达式。目前支持的表达式动态表达式权限包括：permitAll, anonymous, rememberMe, denyAll, authenticated, fullyAuthenticated, hasRole, hasAnyRole
    • 极大地简化了接口数据汇总、权限转换、重叠冲突校验、权限分发等核心代码逻辑。
  • [升级] Spring Boot 版本升级至 3.0.4
  • [升级] Spring Cloud Tencent 版本升级至 1.10.0-2022.0.1
  • [升级] Spring Boot Admin 版本升级至 3.0.1
• 其它更新
  • [漏洞] 强制升级 commons-fileupload 版本至 1.5 ，修复 CVE-2023-24998 安全漏洞
  • [重构] 结合各模块组件的职责及定位，重新划分和调整部分模块的归属。
  • [重构] 原 dante-cloud-upms-logic 和 dante-cloud-upms-rest 代码调整至 dante-engine，后续以组件形式调用。
  • [重构] 原 dante-module-upms-logic 和 dante-module-upms-rest 模块，名称分别变更为 dante-module-social 和 dante-module-metadata，职责和用途更加清晰
  • [重构] 重新定义系统部分管理功能接口路径，增加统一标识方便查看及数据库管理操作。
  • [优化] 优化多级缓存 Key 生成逻辑，解决原有以 JSON 格式作为缓存 Key，导致缓存数据在可视化工具中查看混乱问题。
  • [优化] 前端主要管理功能配合新版动态权限同步优化
  • [修复] 新增在服务多实例情况下，多级缓存权限数据本地同步支持。解决在同一消费组下，未能消费到数据的服务实例校验权限错误问题。
  • [修复] 彻底解决初次搭建过程中因操作步骤错误，产生冗余缓存数据，会出现 Batch update returned unexpected row count from update [0]; actual row count: 0; expected: 1 错误问题
• 依赖更新
  • [升级] springdoc 版本升级至 2.0.3
  • [升级] fastjson2 版本升级至 2.0.25
  • [升级] hutool 版本升级至 5.8.15
  • [升级] wxjava 版本升级至 4.4.9.B
  • [升级] mybatis 版本升级至 3.5.12
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.712
  • [升级] alipay-sdk-java 版本升级至 4.35.71.ALL

v3.0.4.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.4
• 依赖更新
  • [升级] redisson 版本升级至 3.20.0
  • [升级] hutool 版本升级至 5.8.13
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.706

v3.0.3.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.3
  • [升级] 适配 Spring Authorization Server 1.1.0-M1
• 其它更新
  • [修复] 修复单体版 MySQL 数据库初始化脚本错误。fix:#I6HRDP (ISSUED by 柳敏莘)
  • [修复] 修复查询接口中包含 properties 数组属性会导致 Gateway UrlDecode 失败的问题 fix:#I6HOLA (ISSUED by dens)
• 依赖更新
  • [升级] spring-security-cas 版本升级至 5.8.2
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.702
  • [升级] alipay-sdk-java 版本升级至 4.35.65.ALL

v3.0.2.3

• 主要更新
  • [升级] Spring Authorization Server 版本升级至 1.0.1
• 依赖更新
  • [升级] logstash-logback-encoder 版本升级至 7.3
  • [升级] minio 版本升级至 8.5.2
  • [升级] fastjson2 版本升级至 2.0.24
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.697
  • [升级] alipay-sdk-java 版本升级至 4.35.45.ALL
  • [升级] aliyun-sdk-oss 版本升级至 3.16.1
  • [升级] dom4j 版本升级至 2.1.4

v3.0.2.2

• 主要更新
  • [升级] Spring Cloud Tencent 版本升级至 1.9.0-2022.0.1
  • [升级] Debezimu 相关组件版本升级至 2.1
  • [变更] 本地权限数据存储修改为多级缓存，以支持服务多实例权限数据共享。
  • [删除] 删除云片短信发送模块
• 其它更新
  • [重构] 重构权限存储 Key 对象结构，解决 AntPathMatcher 无法序列化导致多级缓存模式下存储权限数据失败问题。
  • [修复] Dashboard 页面，在切换 Tab 后，echarts 宽度不再自适应，显示成 100px 问题。
  • [修复] 根据新版 axios typescript 定义，修改 axios 核心代码解决类型提示错误。
• 依赖更新
  • [升级] redisson 版本升级至 3.19.3
  • [升级] maven-embedder 版本升级至 3.9.0
  • [升级] maven-compat 版本升级至 3.9.0
  • [升级] hutool 版本升级至 5.8.12
  • [升级] alipay-sdk-java 版本升级至 4.35.45.ALL
  • [升级] tencentcloud-sdk-java 版本升级至 3.1.691
  • [升级] com.baidu.aip 版本升级至 4.16.14

v3.0.2.1

• 主要更新
  • [升级] Spring Cloud 版本升级至 2022.0.1
  • [升级] Spring Boot Admin 版本升级至 3.0.0
  • [升级] Spring Cloud Tencent 版本升级至 1.8.5-2022.0.1
  • [升级] Skywalking Agent 版本升级至 8.14.0
• 其它更新
  • [新增] 增加本项目涉及的 Skywalking 常用 Agent Plugins，方便生产环境直接打包使用。
  • [修复] Dashboard 页面，在切换 Tab 后，echarts 宽度不再自适应，显示成 100px 问题。
• 依赖更新
  • [升级] Okhttps 版本升级至 4.0.1

v3.0.2.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.2 fix：#I6B4UT
  • [升级] Spring Boot Admin 版本升级至 3.0.0-M9 fix：#I6B4WO
  • [升级] Spring Cloud Tencent 版本升级至 1.8.4-2022.0.0 fix：#I6B4WM
  • [重构] 重构 Athena 工程模块结构，简化该工程多模块结构，删除多余无意义的结构示例性结构，各模块的用途及含义更简洁清晰
• 其它更新
  • [新增] 针对某一类权限校验并不严格的接口，新增只校验是否认证、不校验授权的权限校验策略，以提高权限校验的灵活度，降低权限配置维护的工作量。
  • [新增] 只校验是否认证、不校验授权的权限校验策略配置
  • [修复] 修复极端情况下，权限缓存数据丢失，接口请求将跳过权限验证的潜在安全问题。
  • [修复] 修复 Spring Cloud Gateway 长期运行后出现 io.netty.util.internal.OutOfDirectMemoryError 问题。fix：#I6AZJX (ISSUED by 狂练胸肌李大懒)
  • [修复] 修复遗漏 Spring Authorization Server 0.4.0 以后新增字段 authorized_scopes 问题
  • [修复] 修复自定义授权模式使用 Refresh Token 重新申请 Token 抛错问题。fix：#6
  • [优化] 将默认 WebSocket 连接地址设置为 permitAll 权限，跳过资源服务器检测，由 WebSocket 模块自主进行权限校验。
  • [优化] 基于 axios 最新版本 typescript 定义，优化前端 @herodotus/core 模块 axios 核心代码，避免编译过程中出现类型校验错误。
• 依赖更新
  • [升级] maven-embedder 版本升级至 3.8.7
  • [升级] maven-compat 版本升级至 3.8.7
  • [升级] redisson 版本升级至 3.19.1
  • [升级] minio 版本升级至 3.5.1
  • [升级] fastjson2 版本升级至 2.0.23
  • [升级] wxjava 版本升级至 4.4.8.B
  • [升级] jetcache 版本升级至 2.7.3
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.681
  • [升级] alipay-sdk-java 版本升级至 4.35.37.ALL

v3.0.1.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.1
  • [升级] Spring Cloud Alibaba 版本升级至 2022.0.0.0-RC1
  • [升级] Spring Cloud Tencent 版本升级至 1.8.2-2022.0.0
  • [升级] Nacos 版本升级至 2.2.1-RC
  • [升级] MyBatis Plus 版本升级至 3.5.3.1
• 新增特性
  • [新增] 新增融合 Stomp WebSocket、私信、公告等功能的独立消息服务。支持前端与后端采用 WebSocket 和 REST 接口互发消息。
  • [新增] 新增私信、公告发送，及新消息提醒、基于私信对话浏览信息功能
  • [新增] 新增手工解析 Token 信息机制，同时支持 JWT Token 和 Opaque Token。
  • [新增] WebSocket 模块，支持 WebSocket Token 鉴权及登录用户信息解析功能
  • [新增] 新增实时在线用户统计及同步实时刷新功能
  • [新增] 前端新增基于用户 ID，动态生成默认 Avatar 功能。
  • [新增] 前端新增独立个人设置页面，包含私信、公告查阅功能
  • [新增] 前端采用新版 Stomp JS 实现 WebSocket 支持。
• 其它更新
  • [优化] 去除额外增加的 JetCache 自动注入配置代码，改为使用新版 JetCache 自身配置。
  • [优化] 在 Token 中增加额外用户信息，方便前端使用，减少重复查询。
  • [优化] 调整部分模块 DTO 代码放置目录
  • [优化] 恢复 Spring Cloud Alibaba 相关代码，删除 Sentinel 临时支持新版 Spring Boot 代码。
  • [优化] 将默认基础设施修改为 Alibaba，删除 Spring Cloud Alibaba 基础设施环境中 Zookeeper 服务发现配置。
  • [重构] 删除 engine-protect 模块，相关代码合并至 engine-rest 模块中
  • [修复] 修复 XSS Request 包装器 Parameter 方法错误，导致无法获取参数错误。
  • [修复] 修复 Anti 萨摩耶 XSS 防护代码额外增加的标识符引起的 WebSocket Token 无法正确解析问题。
  • [修复] 修复因 Hibernate 6 代码变化，导致基于 JetCache 自定义 JPA 二级缓存分页查询数据不正确问题。
  • [修复] 修复前端异常提示框弹出后，在不同时机下，特别是调试阶段，vue-router 实例不存在导致的页面不会刷新问题。
• 依赖更新
  • [升级] jetcache 版本升级至 2.7.2
  • [升级] hutool 版本升级至 5.8.11
  • [升级] spring-boot-admin 版本升级至 3.0.0-M8
  • [升级] spring-security-cas 版本升级至 5.8.1
  • [升级] springdoc 版本升级至 2.0.2
  • [升级] wxjava 版本升级至 4.4.7.B
  • [升级] mybatis-plus-boot-starter 版本升级至 3.5.3.1
  • [升级] mybatis-plus-generator 版本升级至 3.5.3.1
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.667
  • [升级] alipay-sdk-java 版本升级至 4.35.9.ALL
  • [升级] com.baidu.aip 版本升级至 4.16.13

v3.0.0.0

• 重要更新

  • Spring Boot 版本升级至 3.0.0
  • Spring Cloud 版本升级至 2022.0.0
  • Spring Authorization Server 版本升级至 1.0.0
  • Spring Cloud Tencent 版本恒机制 1.8.2-2022.0.0
  • Spring Boot Admin 版本升级至 3.0.0-M6
  • Spring Doc 版本升级至 2.0.1

• 其它更新

  • [重构] 根据新版 Spring Authorization Server 代码结构及类命名，对 Spring Authorization Server 相关代码进行重构适配。
  • [重构] OAuth2 Application 实体类增加 authorization code time-to-live 字段。
  • [重构] OAuth2 Application 中 accessTokenTimeToLive、refreshTokenTimeToLive、authorizationCodeTimeToLive 属性的默认值，修改为与 Spring Authorization Server TokenSettings 一致。
  • [重构] 重构 Spring Authorization Server OAuth2 相关代码分包和模块结构，逻辑更内聚、职责更清晰、模块引用依赖更简洁
  • [重构] 使用 SpringSecurity 6 最新代码逻辑，重新实现接口鉴权。
  • [重构] 重构基于 Redis 的微服务 Session 共享配置代码，采用更合理的配置实现分布式微服务 Session 共享
  • [新增] 新增 Token Settings 授权码模式 Code 有效时间字段。
  • [新增] 在 Nacos 中增加 logback 配置，新增服务可外部化动态读取 logback.xml 配置模式。以便于更加灵活的进行日志输出配置。
  • [新增] 外部配置 logback.xml 中，增加 Skywalking 日志上报、ELK 日志中心日志收集、Skywalking TraceId 等支持。同时提供常规及 MDC 两种配置。
  • [新增] 在统一响应实体 Result 增加 TraceId 信息，在开启 Skywalking Tracing 的情况下，可在返回结果中，统一增加 TraceId，方便跟踪和调试。
  • [变更] 服务注册临时改为使用 zookeeper。
  • [变更] 数据库初始化脚本中的初始数据，与 Spring Authorization Server 0.4.0 最新代码适配
  • [变更] 默认 JDK 版本及 pom.xml 中 <java.version> 指定为变更为 JDK 17。
  • [变更] Docker 默认 JDK 基础镜像变更为 JDK 17。
  • [变更] spring.factories 全部替换为新版格式并启用 @AutoConfiguration。原有 ...AutoConfiguration 形式命名配置类，变更为...Configuration 形式命名。
  • [变更] 取消自定义登录页面中使用 Thymeleaf 内置 Reqeust、Session 对象，改用 Model 方式进行传递。
  • [变更] 适配新版本依赖注解引用及代码用法
  • [变更] 删除 Knife4j 相关依赖，后续版本不再提供 Knife4j API 支持。
  • [变更] 不再提供 docker-maven-plugin 支持，去除相关配置
  • [修复] 使用 Feign 调用接口时，上游接口 content_type 会传递至下游，错误的 content_type 导致下游接口调用出错问题。
  • [修复] 在 3.0.0 环境下，Thymeleaf 不再支持 Request、Session 对象调用，导致自定义 Spring Authorization Server 登录页面解析错误
  • [修复] OpenFeign 使用 OkHttp 做基础请求组件时，启动服务抛出对象无法注入错误问题。
  • [优化] 优化 git-commit-id 配置，变更为只在服务类型模块中生成相关信息，提升主工程编译速度
  • [优化] 优化 dependencies 及 pom 配置，去除冗余重复配置，降低 maven 内容的重复化配置。减少不必要的 Maven 插件配置，提升工程代码整体编译效率
  • [优化] 整体调整各类模块 pom build 配置，适当增加冗余重复配置，以支持 Spring Native 编译需要。规避对所有模块进行 Native 编译产生错误问题。

• 配置变更

  • javax 属性节点全部变更为 jakarta
  • spring.jpa.properties.hibernate.temp.use_jdbc_metadata_defaults 值修改为 true
  • org.hibernate.dialect.PostgreSQL10Dialect 变更为 org.hibernate.dialect.PostgreSQLDialect
  • Redis 相关配置全部移动到 data 属性节点下

• 依赖升级

  • [升级] Nacos 版本升级至 2.2.0
  • [升级] wxjava 版本升级至 4.4.6.B
  • [升级] antisamy 版本升级至 1.7.2
  • [升级] redisson 版本升级至 3.19.0
  • [升级] minio 版本升级至 8.4.6
  • [升级] fastjson2 版本升级至 2.0.21
  • [升级] Hutool 版本升级至 5.8.10
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.650
  • [升级] dysmsapi20170525 版本升级至 2.0.23
  • [升级] alipay-sdk-java 版本升级至 4.35.7.ALL
  • [升级] aliyun-java-sdk-core 版本升级至 4.6.3
  • [升级] qiniu-java-sdk 版本升级至 7.12.1
  • [升级] aliyun-java-sdk-green 版本升级至 3.6.6
  • [升级] postgresql 版本升级至 42.5.1
  • [升级] jackson 版本升级至 2.14.1
  • [升级] jasypt-spring-boot-starter 版本升级至 3.0.5

v3.0.0-RC3

• 主要更新
  • [升级] Spring Cloud 版本升级至 2022.0.0-RC3
  • [新增] Spring Cloud Tencent 熔断、限流、元数据处理支持
• 其它更新
  • [重构] 前端 API 接口调用，修改为 proxy 代理模式，解决前后端跨域导致前端不创建 Cookie，后端 Session Id 不一致，Session 共享不生效问题。
  • [重构] 调整 Engine 工程模块结构，整合消息模块和 WebSocket 模块。
  • [修复] 修复华为云短信发送请求体类型设置错误
  • [修复] 修复模块编译组件时，vite-plugin-dts 提示找不到第三方模块抛出错误提示问题。
• 依赖升级
  • [升级] redisson 版本升级至 3.18.1
  • [升级] alipay-sdk-java 版本升级至 4.34.86.ALL

v3.0.0-RC2

• 主要更新
  • [升级] Spring Cloud Tencent 版本升级至 1.8.1-2022.0.0-RC2
  • [新增] 现有工程新增对 Spring Cloud Tencent 的适配和支持。
  • [新增] 新增 Spring Cloud Alibaba、Spring Cloud Tencent 和 Spring Cloud 原生全家桶微服基础设施适配切换能力，以相对便捷的方式快捷迁移使用 Alibaba、Tencent、Spring 等基础设施环境
• 其它更新
  • [修复] 解决使用 edge 浏览器并使用 feign，报错 Unexpected char 0x0a（PR by 狂练胸肌的李大懒）
  • [修复] 修复前端唯一性字段在新建、编辑不同状态下校验不准确、状态不合理问题。解决导致编辑状态下唯一性字段数据未修改仍会校验失败问题。
  • [修复] 优化微服务分布式 Session 共享配置，解决共享 Session 不一致问题。
  • [修复] 在 docker 环境下，服务默认选择容器内部 IP 而不会映射本机 IP 问题。
  • [优化] 优化 Spring Authorization Server 认证服务配置，整理代码逻辑、去除冗余重复的配置
• 依赖更新
  • [升级] springdoc 版本升级至 2.0.0
  • [升级] fastjson2 版本升级至 2.0.20
  • [升级] dysmsapi20170525 版本升级至 2.0.23
  • [升级] aliyun-java-sdk-core 版本升级至 4.6.3
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.641
  • [升级] alipay-sdk-java 版本升级至 4.34.71.ALL
  • [升级] aliyun-java-sdk-green 版本升级至 3.6.6
  • [升级] postgresql 版本升级至 42.5.1
  • [升级] jackson 版本升级至 2.14.1

v3.0.0-RC1

• 主要更新
  • Spring Boot 版本升级至 3.0.0
  • Spring Authorization Server 版本升级至 1.0.0
• 其它更新
  • [重构] 重构 Spring Authorization Server 扩展模块，调整代码结构，逻辑定位更清晰。删除无用包。
  • [重构] 使用 SpringSecurity 6 最新代码逻辑，重新实现接口鉴权。
  • [重构] 调整部分 Starter 配置类包路径
  • [变更] 服务注册发现临时改用 zookeeper
• 依赖更新
  • [升级] spring-security-cas 版本升级至 5.8.0
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.637
  • [升级] alipay-sdk-java 版本升级至 4.34.64.ALL

v3.0.0-M5

• 主要更新
  • [升级] Spring Cloud 版本升级至 2022.0.0-RC2
  • [修复] 修复使用 Feign 调用接口时，上游接口 content_type 会传递至下游，错误的 content_type 导致下游接口调用出错问题。
  • [修复] 在 3.0.0 环境下，Thymeleaf 不再支持 Request、Session 对象调用，导致自定义 Spring Authorization Server 登录页面解析错误
  • [优化] 优化 Okhttp 与 Feign 整合配置代码
• 依赖更新
  • [升级] jetcache 版本升级至 2.7.1
  • [升级] redisson 版本升级至 3.18.0
  • [升级] fastjson2 版本升级至 2.0.19
  • [升级] wxjava 版本升级至 4.4.5.B
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.633
  • [升级] alipay-sdk-java 版本升级至 4.34.52.ALL
  • [升级] antisamy 版本升级至 1.7.2
  • [升级] hutool 版升级至 5.8.10

v3.0.0-M4

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.0-RC2
  • [升级] SpringDoc 版本升级至 2.0.0-RC1
  • [升级] Skywalking Agent 版本升级至 8.13.0
  • [修复] OpenFeign 使用 OkHttp 做基础请求组件时，启动服务抛出对象无法注入错误问题。
  • [修复] 修复 Spring Cloud Gateway 不兼容低版本 SpringDoc 导致启动出错问题。
  • [修复] 优化 Gateway 请求信息拦截机制，增加对 Feign 内部无权限标记的拦截，修复内部接口被外部直接调用的安全漏洞
  • [删除] 删除 Knife4j 组件依赖，后续版本不在提供 Knife4j 支持。
  • [优化] 优化 SpringDoc 依赖关系及 Swagger UI 包引入。
  • [新增] 在 Nacos 中增加 logback 配置，新增服务可外部化动态读取 logback.xml 配置模式。以便于更加灵活的进行日志输出配置。
  • [新增] 外部配置 logback.xml 中，增加 Skywalking 日志上报、ELK 日志中心日志收集、Skywalking TraceId 等支持。同时提供常规及 MDC 两种配置。
  • [新增] 在统一响应实体 Result 增加 TraceId 信息，在开启 Skywalking Tracing 的情况下，可在返回结果中，统一增加 TraceId，方便跟踪和调试。
  • [变更] 服务注册临时改为使用 zookeeper。
• 依赖升级
  • [升级] jackson 版本升级至 2.14.0
  • [升级] fastjson2 版本升级至 2.0.18
  • [升级] wxjava 版本升级至 4.4.4.B
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.627
  • [升级] qiniu-java-sdk 版本升级至 7.12.0
  • [升级] alipay-sdk-java 版本升级至 4.34.47.ALL

v3.0.0-M3

• 主要更新
  • [升级] Spring Boot 版本升级至 3.0.0-RC1
  • [升级] Spring Cloud 版本升级至 2022.0.0-M5
  • [升级] Spring Authorization Server 版本升级至 1.0.0-RC1
  • [升级] Spring Boot Admin 版本升级至 3.0.0-M5
  • [升级] git-commit-id-maven-plugin 插件依赖更新
  • [重构] Openfeign HttpClient 配置改用 HttpClient5 配置方式
  • [重构] UUIDGenerator 改为 UuidGenerator
  • [重构] 所有涉及 javax 的代码，重构为适配 Jakarta。
  • [重构] 重构 Spring Authorization Server 扩展模块，调整代码结构，逻辑定位更清晰。删除无用包。
  • [重构] 使用 SpringSecurity 6 最新代码逻辑，重新实现接口鉴权。
  • [重构] 原有 JPA @GenericGenerator 注解全部使用最新支持方式替换
  • [重构] 将 JPA 过时查询缓存标记常量修改为最新常量
  • [重构] spring.factories 全部替换为新版格式
  • [重构] 重构权限数据存储、分发代码，替换原有 Spring Security 5 逻辑。
  • [新增] 临时新增 Sentinel Spring WebMvc Adapter，以解决 当前版本 Sentinel 没有没有适配 Jakarta 问题
  • [删除] 删除原有自定义 Hibernate PostgreSQL Jsonb 支持代码
  • [优化] hibernate dialect 改为 org.hibernate.dialect.PostgreSQLDialect
  • [优化] 更新 Redis 和 JetCache 配置，适配最新版 Spring Boot
  • [优化] 调整 jetcache 依赖，临时解决 Bean 注入顺序不生效问题
  • [优化] use_jdbc_metadata_defaults: true 修改为 true

v3.0.0-M2

• 主要更新
  • [升级] Spring Authorization Server 版本升级至 0.4.0-M2
  • [重构] 重构核心代码，适配 Spring Authorization Server 0.4.0-M2。

v3.0.0-M1

• 主要更新
  • [变更] 默认 JDK 版本及 pom.xml 中 <java.version> 指定为变更为 JDK 17。
  • [变更] Docker 默认 JDK 基础镜像变更为 JDK 17。
  • [升级] Spring Authorization Server 版本升级至 0.4.0-M1
  • [重构] 根据新版 Spring Authorization Server 代码结果及变更，对现有工程代码进行重构适配。
  • [重构] OAuth2 Application 实体类增加 authorization code time-to-live 字段。
  • [重构] OAuth2 Application 中 accessTokenTimeToLive、refreshTokenTimeToLive、authorizationCodeTimeToLive 属性的默认值，修改为与 Spring Authorization Server TokenSettings 一致。
  • [变更] 变更数据库初始化脚本中的初始数据，与最新代码适配
• 依赖更新
  • [升级] wxjava 版本升级至 4.4.4.B
  • [升级] tencentcloud-sdk-java-sms 版本升级至 3.1.623
  • [升级] qiniu-java-sdk 版本升级至 7.12.0
  • [升级] alipay-sdk-java 版本升级至 4.34.43.ALL

• 主要更新
  • [升级] Spring Boot 版本升级至 3.1.12
• 其它更新
  • [修复] 修复日志代码引入类不规范问题。fix: #I9QR01 (ISSUED by 杨运交)
  • [修复] 修复 Webjars JQuery 重复引入造成等登录页面单独访问无法加载问题。fix: #I9QRT0 (ISSUED by 杨运交)
  • [修复] 修复授权码模式开启确认页面显示 401 无权限问题。fix: #I9QS1H (ISSUED by 杨运交)
  • [修复] 修复 Dante OSS 单独引入 Aliyun OSS 配置不会注入错误
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.728
  • [升级] com.baidu.aip 版本升级至 4.16.19
  • [升级] alipay-sdk-java 版本升级至 4.39.79.ALL
• 升级说明
  • 因 Spring Boot 3.1.X 于 2024年5月停止维护，所以 Dante Cloud 也同步停止维护。3.1.12.0-Final 为 3.1.X 系列最后一个版本

v3.1.11.3

• 主要更新
  • [修复] 修复 Spring Authorization Server 自定义登录页面静态内容 webjars 加载错误
  • [修复] 修复 commons text 版本依赖错误导致运行抛错问题
  • [修复] 修复内置授权码登录页面，控制台抛错错误问题
  • [修复] 修复内置授权码登录页面脚本依赖模块丢失问题
  • [修复] 修复接口扫描条件配置默认值错误导致系统登录没有权限问题
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.725
  • [升级] influxdb-client 版本升级至 7.1.0
  • [升级] fastjson2 版本升级至 2.0.50
  • [升级] quasar webjars 版本升级至 2.16.4
  • [升级] alipay-sdk-java 版本升级至 4.39.74.ALL

v3.1.11.2

• 主要更新
  • [优化] 代码适配 Hutool 6.0.0-M12
• 其它更新
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-05-10T01-41-38Z
• 依赖更新
  • [升级] guava 版本升级至 33.2.0-jre
  • [升级] redisson 版本升级至 3.30.0
  • [升级] Hutool 版升级至至 6.0.0-M12
  • [升级] aws-java-sdk-s3 版本升级至 1.12.720
  • [升级] font-awesome webjars 版本升级至 6.5.2
  • [升级] quasar 版本升级至 2.16.1
  • [升级] alipay-sdk-java 版本升级至 4.39.70.ALL
  • [升级] mysql 版本升级至 8.4.0
  • [升级] checker-qual 版本升级至 3.43.0

v3.1.11.1

• 主要更新
  • [升级] Spring Cloud Tencent 版本升级至 1.13.2-2022.0.4
  • [发布] 发布基于 Nacos 2.3.2、使用 Postgresql 数据库作为存储、支持amd、arm 等多CPU架构的 Herodotus Nacos Server Docker 镜像已发布至 Docker Hub。
  • [发布] 基于 Dante 最新代码重新打包，herodotus/ sentinel-dashboard 镜像。优化打包方式，新增 amd、arm 等多种 CPU 架构支持。
• 其它更新
  • [修复] 修复前端组件库编译出现 Error: Cannot find module @rollup/rollup-win32-x64-msvc. 错误 fix: #I9IYT3
• 依赖更新
  • [升级] maven-gpg-plugin 版本升级至 3.2.4
  • [升级] redisson 版本升级至 3.29.0
  • [升级] aws-java-sdk-s3 版本升级至 1.12.709
  • [升级] quasar webjars 版本升级至 2.15.4
  • [升级] vue webjars 版本升级至 3.4.23
  • [升级] alipay-sdk-java 版本升级至 4.39.58.ALL
  • [升级] xnio 版本升级至 3.8.14.Final
  • [升级] minio 版本升级至 8.5.10

v3.1.11.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.1.11
  • [升级] Spring Authorization Sever 版本升级至 1.1.7
  • [升级] Debezium 版本升级至 2.6
• 其它更新
  • [修复] 当前的CRUD模式局限于从列表页发起编辑详情页，不能从左侧菜单或其它链接入口发起问题 （感谢 James7 PR）
  • [修复] 面包屑中间节点对应左侧菜单目录节点，删除链接避免与左侧展开动作逻辑不一致问题（感谢 James7 PR）
  • [新增] 添加了审批流程和任务流程空页面，搭配前端修复后端加载的Workbench路由，保障保障菜单与标签页整体界面交互逻辑完整展示（感谢 James7 PR）
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-04-18T19-09-19Z
• 依赖更新
  • [升级] maven-gpg-plugin 版本升级至 3.2.3
  • [升级] commons-io 版本升级至 2.16.1
  • [升级] redisson 版本升级至 3.28.0
  • [升级] aws-java-sdk-s3 版本升级至 1.12.704
  • [升级] fastjson2 版本升级至 2.0.49
  • [升级] sms4j-spring-boot-starter 版本升级至 3.2.1
  • [升级] vue webjars 版本升级至 3.4.22
  • [升级] alipay-sdk-java 版本升级至 4.39.42.ALL
  • [升级] commons-text 版本升级至 1.12.0
  • [升级] bcprov-jdk18on 版本升级至 1.78.1
  • [升级] bcpkix-jdk18on 版本升级至 1.78.1
  • [升级] sqlite-jdbc 版本升级至 3.45.3.0

v3.1.10.2

• 主要更新
  • [升级] Spring Boot Admin 版本升级至 3.2.3
  • [升级] Skywalking 版本升级至 9.2.0
  • [升级] Camunda 版本升级至 7.21.0 正式版。同步更新对应版本 OpenApi 和 SQL 脚本
• 其它更新
  • [新增] 前端 Dashboard 新增后端基础设施管理页面快速访问入口
  • [修复] 处理了TabsView标签页锁定不固定、详情页与列表管理页位置关系不一致问题（感谢 James7 提交的 PR）
  • [优化] 添加了标签右键操作菜单、添加了ToolBar独立刷新按钮，支持再关闭标签页布局时仍支持刷新当前页（感谢 James7 提交的 PR）
  • [优化] 优化前端 Dashboard 默认图表文字显示。
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-04-06T05-26-02Z
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.696
  • [升级] mybatis plus 版本升级至 3.5.6
  • [升级] mybatis 版本升级至 3.5.16
  • [升级] alipay-sdk-java 版本升级至 4.39.31.ALL
  • [升级] maven-source-plugin 版本升级至 3.3.1
  • [升级] bcprov-jdk18on 版本升级至 1.78

v3.1.10.1

• 主要更新
  • [升级] Nacos 版本升级至 2.3.2
• 其它更新
  • [升级] Nacos docker 镜像版本升级至 v2.3.2
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-03-30T09-41-56Z
• 依赖更新
  • [升级] maven-gpg-plugin 版本升级至 3.2.2
  • [升级] commons-io 版本升级至 2.16.0
  • [升级] springdoc 版本升级至 2.5.0
  • [升级] aws-java-sdk-s3 版本升级至 1.12.692
  • [升级] fastjson2 版本升级至 2.0.48
  • [升级] hutool 5.X 版本升级至 5.8.27
  • [升级] sms4j 版本升级至 3.2.0
  • [升级] animate.css 版本升级至 4.1.1
  • [升级] jquery-backstretch 版本升级至 2.1.17
  • [升级] mdi/font webjars 版本升级至 7.4.47
  • [升级] quasar webjars 版本升级至 2.15.1
  • [升级] vue webjars 版本升级至 3.4.21
  • [升级] alipay-sdk-java 版本升级至 4.39.19.ALL

v3.1.10.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.1.10
  • [升级] Spring Authorization Server 版本升级至 1.1.6
• 其它更新
  • [修复] 修复自定义 FeignErrorDecoder 处理代码，判断逻辑错误问题 fix: #I99O2G (ISSUED by 杨交运)
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-03-15T01-07-19Z
• 依赖更新
  • [升级] guava 版本升级至 33.1.0-jre
  • [升级] aws-java-sdk-s3 版本升级至 1.12.683
  • [升级] alipay-sdk-java 版本升级至 4.39.2.ALL
  • [升级] okio 版本升级至 3.9.0
  • [升级] git-commit-id-maven-plugin 版本升级至 8.0.2
  • [升级] sqlite-jdbc 版本升级至 3.45.2.0

v3.1.9.2

• 主要更新
  • [新增] Nacos 2.3.1 SQL 脚本
  • [优化] 明确各个版本及分支代码版权信息
• 其它更新
  • [修复] 修复前端设计自定义组件模块在新版本 vue 和 vite 环境下，因 Typescirpt 类型错误导致编译失败问题
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-03-07T00-43-48Z
• 依赖更新
  • [升级] maven-gpg-plugin 版本升级至 3.2.0
  • [升级] redisson 版本升级至 3.27.2
  • [升级] springdoc 版本升级至 2.4.0
  • [升级] aws-java-sdk-s3 版本升级至 1.12.676
  • [升级] alipay-sdk-java 版本升级至4.38.221.ALL
  • [升级] org.json 版本升级至 20240303
  • [升级] git-commit-id-maven-plugin 版本升级至 8.0.1

v3.1.9.1

• 主要更新
  • [升级] Nacos 版本升级至 2.3.1
• 其它更新
  • [安全] 增加 Hutool 5.X pom 配置，修复 SMS4J 依赖 Hutool 低版本携带的 CVE 问题。
  • [修复] 修复前端粒子效果卡顿问题
  • [升级] Nacos docker 镜像版本升级至 v2.3.1
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-03-03T17-50-39Z
• 依赖更新
  • [升级] redisson 版本升级至 3.27.1
  • [升级] minio 版本升级至 8.5.9
  • [升级] aws-java-sdk-s3 版本升级至 1.12.671
  • [升级] fastjson2 版本升级至 2.0.47
  • [升级] bootstrap webjars 版本升级至 5.3.3
  • [升级] alipay-sdk-java 版本升级至 4.38.221.ALL
  • [升级] xnio 版本升级至 3.8.13.Final

v3.1.9.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.1.9
  • [升级] Spring Authrization Server 版本升级至 1.1.5
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.663
  • [升级] alipay-sdk-java 版本升级至 4.38.212.ALL

v3.1.8.4

• 主要更新
  • [升级] Spring Cloud Tencent 版本升级至 1.13.1-2022.0.4
  • [升级] Spring Boot Admin 版本升级至 3.2.2
  • [回滚] Spring Cloud 版本降级至 2022.0.4
• 其它更新
  • [重构] 代码适配 Hutool 6.0.0-M11
  • [回滚] 回滚 Spring Cloud 版本至 2022.0.4，以解决新版本 Spring Cloud 升级 Feign 版本导致的 Spring Cloud Tencent 版本不兼容问题
  • [修复] 修复前端 tsParticles 代码问题，导致整个前端无法运行问题
  • [修复] 修复前端静态路由自动校验错误
  • [修复] 修复伴随 Spring Boot 版本，起的 Netty 版本升级，导致的 Spring Cloud Tencent 代码不兼容运行出错问题。
  • [修复] 修复 Spring Cloud Tencent 配置逻辑问题，导致服务启动出现 The bean 'restTemplateCustomizer', defined in class path resource [com/tencent/cloud/polaris/loadbalancer/PolarisLoadBalancerAutoConfiguration.class], could not be registered. A bean with that name has already been defined in class path resource [org/springframework/cloud/client/loadbalancer/LoadBalancerAutoConfiguration$RetryInterceptorAutoConfiguration.class] and overriding is disabled.
  • [优化] 优化以 Spring Cloud Tencent 作为微服务基础设置的模式下日志输出内容
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-02-17T01-15-57Z
• 依赖升级
  • [升级] redisson 版本升级至 3.27.0
  • [升级] minio 版本升级至 8.5.8
  • [升级] aws-java-sdk-s3 版本升级至 1.12.661
  • [升级] hutool 版本升级至 6.0.0-M11
  • [升级] com.baidu.aip 版本升级至 4.16.18
  • [升级] org.json 版本升级至 20240205
  • [升级] okio 版本升级至 3.8.0

v3.1.8.3

• 主要更新
  • [升级] Spring Cloud Tencent 版本升级至 1.13.0-2022.0.4
• 其它更新
  • [修复] 修复伴随 Spring Boot 版本，起的 Netty 版本升级，导致的 Spring Cloud Tencent 代码不兼容运行出错问题。
  • [修复] 修复前端提示，在 “module” 模式下无法读取 .eslintrc.js 问题
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-02-04T22-36-13Z
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.652

v3.1.8.2

• 主要更新
  • [升级] 升级 Antisamy XSS 防护策略配置文件
• 其它更新
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-01-31T20-20-33Z
• 依赖更新
  • [升级] antisamy 版本升级至 1.7.5
  • [升级] zxing 版本升级至 3.5.3
  • [升级] aws-java-sdk-s3 版本升级至 1.12.650
  • [升级] influxdb-client 版本升级至 7.0.0
  • [升级] fastjson 版本升级至 2.0.46
  • [升级] sqlite-jdbc 版本升级至 3.45.1.0

v3.1.8.1

• 主要更新
  • [升级] Spring Cloud 版本升级至 2022.0.5
• 其它更新
  • [优化] 去除核心 Dependencies 中无用的依赖配置
  • [优化] 优化 Cache 相关模块代码，修改部分包名、代码以及注解的使用，符合 Spring 规范的命名和使用方式
  • [优化] 临时去除 Sentinel 相关依赖及自动注入，规避 Sentinel 与最新 Openfeign 不兼容问题。
  • [安全] 修复 Jayway JsonPath 安全漏洞(CVE-2023-51074) fix: #I8XWGJ
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-01-18T22-51-28Z
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.645
  • [升级] JetCache 版本升级至 2.7.5
  • [升级] vue webjars 版本升级至 3.4.15
  • [升级] alipay-sdk-java 版本升级至 4.38.200.ALL
  • [升级] sqlite-jdbc 版本升级至 3.45.0.0

v3.1.8.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.1.8
• 其它更新
  • [优化] 彻底清除系统中 facility 相关模块依赖的 bcpkix-jdk15on，解决 bcpkix 不同版本依赖冲突导致的前后端数据加密异常问题。fix: #I8XHFK
  • [优化] 清除为临时解决 SMS4J 启动输出错误信息的相关配置
  • [升级] minio docker 镜像版本升级至 RELEASE.2024-01-16T16-07-38Z
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.638
  • [升级] sms4j 版本升级至 3.1.1
  • [升级] vue webjars 版本升级至 3.4.14
  • [升级] mysql-connector-j 版本升级至 8.3.0

v3.1.7.5

• 主要更新
  • [修复] 排除所有 bcprov-jdk15on 依赖，彻底解决模拟 SmUtil 抛出 java.lang.NoClassDefFoundError: Could not initialize class org.dromara.hutool.crypto.bc.SmUtil 问题 fix: #I8WPZZ
• 其它更新
  • [修复] 修复 yml 中 @ 占位符编译时不会被替换问题
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.637
  • [升级] redisson 版本升级至 3.26.0
  • [升级] vue webjars 版本升级至 3.4.13

v3.1.7.4

• 主要更新
  • [修复] sms4j 依赖 hutool 5.x 和 hutool 6.x crypto 国密SMUtil 模块放在一个工程中会产生冲突 fix: #I8W59R
  • [修复] 升级hutool 版本至 6.0.0-M10 抛出 java.lang.NoClassDefFoundError: Could not initialize class org.dromara.hutool.crypto.bc.SmUtil fix: #I8W5AN
• 其它更新
  • [优化] 适配 Hutool 6.0.0-M10
  • [升级] minio 镜像版本升级至 RELEASE.2024-01-13T07-53-03Z
• 依赖更新
  • [升级] hutool 版本升级至 6.0.0-M10
  • [升级] aws-java-sdk-s3 版本升级至 1.12.636
  • [升级] vue webjars 版本升级至 3.4.12
  • [升级] alipay-sdk-java 版本升级至 4.38.192.ALL

v3.1.7.3

• 主要更新
  • [升级] Spring Boot Admin 版本升级至 3.2.1
  • [重构] 改用 SMS4J 作为系统短信发送组件，重构相关代码，增加 access-sdk-sms 模块，删除已有 SMS 相关所有代码模块
• 其它更新
  • [安全] 修复 CVE-2023-22102 未经身份验证的攻击者通过多个协议发送恶意请求，最终接管MySQL Protocol漏洞 fix: #I8T9LR
  • [优化] 优化数据库初始化脚本
  • [升级] minio 镜像版本升级至 RELEASE.2024-01-11T07-46-16Z
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.634
  • [升级] fastjson 版本升级至 2.0.45
  • [升级] vue webjars 版本升级至 3.4.7

v3.1.7.2

• 主要更新
  • [升级] Debezium 版本升级至 2.5
  • [重构] 全面改用 Nacos V2 API，支持微服务流量监控数据持久化存储到 Influxdb 时序数据库，支持通过 Sentinel Dashboard 界面管理存储在 Nacos 中的流量控制配置。支持 Nacos 认证模式。可通过配置开启或关闭相关支持。注意：该版本仅适用于 Nacos 2.2.2 及以上版本。
  • [发布] 基于 Sentinel 1.8.7 扩展改造的 Dante Sentinel Dashboard Docker 镜像已发布并上传至 Docker Hub。
• 其它更新
  • [修复] Mybatis Plust 版本升级至 3.5.5，修复 Bean named 'ddlApplicationRunner' is expected to be of type 'org.springframework.boot.Runner' but was actually of type 'org.springframework.beans.factory.support.NullBean' 错误问题
  • [修复] 修复自主封装 Sentinel Dashboard 配置持久化至 Nacos 不支持认证问题。fix: #I6HZJI
  • [升级] Dockerfile 基础镜像 bellsoft/liberica-openjdk-debian 版本升级至 17.0.9-11
  • [升级] Dockerfile 镜像 herodotus/sentinel-dashboard 版本升级至 1.8.7
  • [优化] 优化 Nacos API 返回值处理，支持错误信息返回
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.628
  • [升级] transmittable-thread-local 版本升级至 2.14.5
  • [升级] mybatis-plus 版本升级至 3.5.5
  • [升级] mybatis 版本升级至 3.5.15
  • [升级] wxjava 版本升级至 4.6.0
  • [升级] font-awesome webjars 版本升级至 6.5.1
  • [升级] vue webjars 版本升级至 3.4.0
  • [升级] aliyun-sdk-oss 版本升级至 3.17.4
  • [升级] alipay-sdk-java 版本升级至 4.38.183.ALL
  • [升级] qiniu-java-sdk 版本升级至 7.15.0

v3.1.7.1

• 主要更新
  • [升级] spring-boot-admin 版本升级至 3.2.0
  • [修复] 采用临时版本，解决 mybatis-plus 与 Spring Boot 3.1.7 和 3.2.1 版本不兼容，启动抛出 Bean named 'ddlApplicationRunner' is expected to be of type 'org.springframework.boot.Runner' but was actually of type 'org.springframework.beans.factory.support.NullBean' 错误问题
• 其它更新
  • [升级] Camunda 版本升级至 2.5
  • [升级] minio docker 镜像版本升级至 RELEASE.2023-12-23T07-19-11Z
  • [新增] 在线文档和项目 Readme 新增出厂安全测试说明
  • [优化] 代码适配 Hutool 6.0.0-M9
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.625
  • [升级] hutool 版本升级至 6.0.0-M9
  • [升级] fastjson2 版本升级至 2.0.44

v3.1.7.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.1.7
  • [升级] Spring Authorization Server 版本升级至 1.1.4
• 其它更新
  • [修复] 修复在不使用系统统一 Session 环境下，，单独调用接口特别是测试接口时，提示 Session 过期的问题。fix：#I8PZY1
  • [新增] 新增系统现有错误体系，发现未能识别的错误时，在日志中打印提醒功能。fix: #I8Q187
  • [重构] 重构自定义 OAuth 2 授权模式代码，提取公共重复代码，去除 IDE 中代码重复提示。
  • [修复] 临时去除 mybatis-plus 相关依赖，解决 mybatis-plus 与 Spring Boot 3.1.7 和 3.2.1 版本不兼容，启动抛出 Bean named 'ddlApplicationRunner' is expected to be of type 'org.springframework.boot.Runner' but was actually of type 'org.springframework.beans.factory.support.NullBean' 错误问题。fix: #I8QJ9V
  • [升级] minio docker 镜像版本升级至 RELEASE.2023-12-20T01-00-02Z
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.622
  • [升级] redisson 版本升级至 3.25.2
  • [升级] influxdb-client 版本升级至 6.12.0
  • [升级] alipay-sdk-java 版本升级至 4.38.170.ALL
  • [升级] okio 版本升级至 3.7.0

v3.1.6.3

• 主要更新
  • [重构] 重构自定义错误体系代码，去除 Feedback 类型多余的构造函数方法。fix:#I8PFQH
  • [修复] 修复自定义错误体系中，自定义的非 HttpStatus 类型错误不生效问题。fix: #I8PFQK
  • [修复] 修复自定义错误体系中，自定义类型错误，自动计算的错误码不正确问题。fix: #I8PFQP
  • [修复] 修复自定义错误体系抛出“Cannot invoke "java.lang.Integer.intValue()" because the return value of ...” 错误问题。fix: I8PNJ0
  • [优化] 更正自定义错误体系中，Validation 校验失败抛出错误的错误类型和错误编码 fix: #I8PFQT
• 其它更新
  • [优化] 优化核心 Controller 定义，增加数组类型数据转换为统一响应实体 Result 支持。
  • [新增] 新增外部 Open Api 调用失败统一 Exception。
  • [修复] 修复核心 Controller 定义，返回字符串类型数据，数据设置错误导致不显示结果问题。fix: #I8PFV1
  • [升级] minio docker 镜像版本升级至 RELEASE.2023-12-14T18-51-57Z
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.619
  • [升级] wxjava 版本升级至 4.5.9.B
  • [升级] vue webjars 版本升级至 3.3.11
  • [升级] aliyun-sdk-oss 版本升级至 3.17.3
  • [升级] alipay-sdk-java 版本升级至 4.38.161.ALL
  • [升级] checker-qual 版本升级至 3.42.0
  • [升级] redisson 版本升级至 3.25.1
  • [升级] guava 版本升级至 33.0.0-jre

v3.1.6.2

• 主要更新
  • [修复] 修复 Spring Authorization Server 客户端配置缺少 MacAlgorithm 类型相关加密算法错误 fix: #I8NWX5
  • [优化] 优化前端 OAuth2 配置，增加选择 private_key_jwt 或 client_secret_jwt 模式时，加密算法选择的联动处理，防止错误选择。fix: #I8O0GD
• 其它更新
  • [重构] Emqx 系统客户端状态转 ApplicationEvent 重构完成。支持系统主题订阅和 Webhook 两种模式。
  • [重构] 重构 Nacos API 封装 SDK，改变原有登录逻辑及配置参数，适配最新的 2.2.2 以上版本 API。
  • [优化] 优化基础 Controller result 方法定义，去除以 ID 作为类型的方法定义。规避重载方法类型判断不正确问题。
  • [优化] 升级前端粒子效果组件版本，采用最新方式重新实现前端粒子显示，并更新粒子效果。fix: #I8NZOX
  • [修复] 修复前端 OAuth2Application Typescript 属性类型映射错误问题。fix: #I8NWXP
  • [修复] 修复前端自定义 Datetime组件 v-close-popup 引入错误，在控制台抛出告警信息问题 fix: I8NWY8
  • [修复] 增强前端登录页面响应式效果，修复在某些环境下登录框过窄的问题。fix: #I8NZMO
  • [修复] 解决 Nacos API 封装 SDK 在最新版本环境下登录出错问题。
  • [新增] 新增 Nacos API 登录单元测试
  • [新增] 新增获取 Nacos 命名空间列表 Rest API 单元测试代码
  • [新增] 新增 Nacos 配置历史 API 封装
  • [新增] 新增 Nacos 命名空间 API 封装
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.610
  • [升级] skywalking agant 版本升级至 9.1.0
  • [升级] checker-qual 版本升级至 3.41.0

v3.1.6.1

• 主要更新
  • [升级] Nacos 版本升级至 2.3.0
• 其它更新
  • [修复] 修复 Nacos 配置整体导入包错误
  • [升级] nacos 镜像版本升级至 v2.3.0
  • [升级] minio 镜像版本升级至 RELEASE.2023-12-09T18-17-51Z
• 依赖更新
  • [升级] commons-io 版本升级至 2.15.1
  • [升级] redisson 版本升级至 3.25.0
  • [升级] springdoc 版本升级至 2.3.0
  • [升级] aws-java-sdk-s3 版本升级至 1.12.609
  • [升级] influxdb-client 版本升级至 6.11.0
  • [升级] fastjson2 版本升级至 2.0.43
  • [升级] transmittable-thread-local 版本升级至 2.14.4
  • [升级] JustAuth 版本升级至 1.16.6
  • [升级] wxjava 版本升级至 4.5.8.B
  • [升级] quasar webjars 版本升级至 2.14.0
  • [升级] vue webjars 版本升级至 3.3.9
  • [升级] aliyun-sdk-oss 版本升级至 3.17.3
  • [升级] alipay-sdk-java 版本升级至 4.38.157.ALL
  • [升级] sqlite-jdbc 版本升级至 3.44.1.0

v3.1.6.0

• 主要更新
  • [升级] Spring Boot 版本升级至 3.1.6
• 其它更新
  • [优化] 优化 message-sdk-mqtt 模块代码，明确入站、出站以及通道相关代码。增加系统统一通道定义类，便于后续其它模块集成使用。 fix: #I8IPWG
• 依赖更新
  • [升级] aws-java-sdk-s3 版本升级至 1.12.594
  • [升级] alipay-sdk-java 版本升级至 4.38.144.ALL
  • [升级] bcprov-jdk15to18 版本升级至 1.77
  • [升级] bcprov-jdk18on 版本升级至 1.77