Red Hat build of Quarkus 3.20 发行注记

在红帽构建的 Quarkus 3.20 中，以下扩展将 Fabric8 Kubernetes 客户端从版本 6.13 升级到 7.1。

这个升级对性能、兼容性和测试提供了一些改进。

Fabric8 Kubernetes Client 7.1 的一些主要优点：

这个更改引入了破坏更改。详情请查看 本发行版本部分的"更改会影响较早版本"部分的"更改"中的备注。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

从红帽构建的 Quarkus 3.20 开始，红帽构建器和运行时基础镜像默认使用 Red Hat Universal Base Image 9 (UBI 9)。

以下镜像已升级：

此升级引入了破坏更改。构建器和运行时基础镜像升级到 UBI 9。

要手动升级到 UBI 9 镜像，下表概述了您的选项：

如果您在基于 UBI 9 的运行时镜像时遇到问题，您可以手动切换到基于 UBI 8 的镜像。详情请参阅 Builder 和运行时基础镜像升级到 UBI 9。

如需更多信息，请参阅以下资源：

使用红帽构建的 Quarkus 3.20，扩展现在可以声明仅在开发模式(dev 模式)或满足特定条件的情况下激活的条件依赖项，避免在正常和测试模式中不必要的依赖项。

如需更多信息，请参阅 Quarkus "Conditional extension dependencies" 指南中的 Dev mode-only extension dependencies 部分。

红帽构建的 Quarkus 3.20 更新区域设置处理，使其与 Mandrel 版本 24.2 及更新版本保持一致。

现在，应用程序在运行时使用一致的默认区域设置，独立于构建系统的区域设置。这个变化提高了跨环境敏感行为的可移植性和可预测性。

这个更改引入了破坏更改。详情请查看 本发行版本部分的"更改会影响较早版本"部分的"更改"中的备注。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

从红帽构建的 Quarkus 3.20 开始，quarkus-agroal 扩展添加了一个专用的 Agroal - 数据库连接 卡，以及用于监控到 Dev UI 的数据库连接的页面。

如果您的 Quarkus 应用程序包含使用 quarkus-agroal 扩展名的 JDBC 驱动程序扩展，则它会自动包含在应用程序中。

在 Dev UI 中，您可以喜欢(star) Agroal - 数据库连接池 卡。您还可以将 Database 视图 链接从卡拖到 Dev UI 菜单。点 Database 视图 会打开 Agroal - Database connection 池 页面，您可以在其中查看所有活跃的数据源，包括连接 URL。

此功能增强简化了 Dev UI 中的数据库监控和配置，改进了调试和数据库管理。

在红帽构建的 Quarkus 3.20 中，quarkus-datasource 扩展现在在应用程序启动期间使用 ArC 优化的依赖项注入框架验证数据源配置。此功能增强可确保早期检测到错误配置，防止运行时失败并降低流量路由到有故障实例的风险。

红帽构建的 Quarkus 的主要变化：

如需更多信息，请参阅"Configure 数据源"指南中的 Activate 或 deactivate datasources 部分。

红帽构建的 Quarkus 3.20 引进了 quarkus-messaging-kafka 扩展，它通过 SmallRye Reactive Messaging Kafka 连接器添加了对 Apache Kafka 事务的支持。此功能支持对多个 Kafka 主题和分区的原子写入，确保事务中的所有记录都被提交或无，在事件驱动的应用程序中增强数据一致性。​

此功能 作为技术预览功能提供。

如需更多信息，请参阅 Quarkus "Apache Kafka 参考指南" 指南中的 Kafka Transactions 部分。

从红帽构建的 Quarkus 3.20 开始，扩展开发人员可以在 Dev UI footer 中创建自定义日志标签页，并将日志数据流传输到其中。此过程类似于在 Dev UI 中创建卡或页面。

Log 标签页为应用程序开发人员提供持续的数据，以便在不切换工具的情况下监控应用程序并进行故障排除。与不离开时与后端断开连接的页面不同，日志选项卡将永久保持连接。

如需更多信息，请参阅 Quarkus "Dev UI for extension developers" 指南中的 Add a footer tab 部分。

红帽构建的 Quarkus 3.20 在使用 LGTM Dev Services 时提供多个预先配置的 Grafana 仪表板。这些仪表板视觉化应用程序指标、跟踪和日志。它们将 OpenTelemetry 用于无缝数据收集和演示。有些仪表板以多种方式显示 Micrometer 数据，包括 OpenTelemetry 输出。每个仪表板都针对特定的应用程序设置进行调优。

可用的仪表板有：

由于计算在滑动时间窗内，一些仪表板面板可能需要几分钟时间来显示准确的数据。

在这个版本中，您可以使用 quarkus.otel.traces.suppress-application-uris 配置属性从 OpenTelemetry 中排除特定的 URI。这可让您定义 tracer 应忽略的、以逗号分隔的 URI 模式列表。

例如，设置 quarkus.otel.traces.suppress-application-uris=trace,ping,people* 将关闭对 /trace 和 /ping URI 的追踪，以及以 /people 开始的任何 URI，如 /people/1 或 /people/1/cars。

如果您使用自定义 quarkus.http.root-path，请确保将其包含在配置中。

在 Red Hat build of Quarkus 3.20 中，quarkus-opentelemetry 扩展增加了对 SimpleSpanProcessor 的支持，后者在完成后立即导出 span 和 logs。在无服务器环境和短期应用程序中，这个行为特别有用。

要启用此功能，请将以下配置属性设置为 true ：

quarkus.otel.simple=true

quarkus.otel.simple=true

此配置替换了默认的 BatchSpanProcessor，确保跨越和日志会立即发送，而不是被缓冲。这个变化对于 Lambda 功能和其他简短进程至关重要，因为它确保在应用程序关闭前导出遥测数据，从而防止因为批处理延迟导致的数据丢失。

在 Red Hat build of Quarkus 3.20 中，quarkus-opentelemetry 扩展现在支持 OpenTelemetry (OTel)日志记录。您可以使用此功能为交互式 Web 应用程序提供分布式日志记录。

要启用此功能，请将以下配置属性设置为 true ：

quarkus.otel.logs.enabled=true

quarkus.otel.logs.enabled=true

如需更多信息，请参阅使用 OpenTelemetry Logging 的 Quarkus 指南。

在红帽构建的 Quarkus 3.20 中，quarkus-opentelemetry 扩展为 JVM 和 HTTP 服务器请求指标提供自动检测，并与 MicroProfile Telemetry 2.0 规格保持一致，只要 OpenTelemetry 指标已启用。

OpenTelemetry 指标默认为禁用。要收集 JVM 和 HTTP 服务器请求指标，您必须通过设置 quarkus.otel.metrics.enabled=true 来启用它们。

对应的配置属性会被默认启用，可以通过在配置中设置 quarkus.otel.instrument.jvm-metrics=false 或 quarkus.otel.instrument.http-server-metrics=false 来禁用。

带有 OpenTelemetry Metrics 集成功能的 Fault Tolerance 目前不被支持。

红帽构建的 Quarkus 3.20 添加了对在单个请求中使用多个身份验证机制的支持。现在，您可以在同一身份验证流中组合使用 mutual TLS (mTLS)和 OpenID Connect (OIDC) bearer 令牌身份验证等机制。

默认情况下，当第一个 SecurityIdentity 由其中一个注册身份验证机制生成时，身份验证会完成。要要求所有机制来验证凭据，请通过设置配置属性来启用包含的身份验证。

这个功能在组合 mutual TLS 和 bearer 令牌身份验证时很有用，例如在需要访问令牌绑定到客户端证书的情况下。

如需更多信息和示例，请参阅"安全架构" 指南中的组合身份验证机制 部分。

Red Hat build of Quarkus 3.20 添加了对在 meta-annotations 中使用 @PermissionsAllowed 的支持，以便您可以创建自定义安全注解以获得更精简的访问控制管理。

此功能增强简化了基于权限的配置，减少重复的安全代码，并提高了可维护性。现在，您可以定义封装 @PermissionsAllowed 的可重复使用的安全注释，使权限处理更高效和一致。

如需更多信息和示例，请参阅"web 端点授权"指南中的 Create permissions meta-annotations 部分。

从红帽构建的 Quarkus 3.20 开始，您可以使用 @PermissionChecker 注释在 CDI bean 方法中定义声明性权限检查器。此功能增强通过允许权限检查与资源类单独实施，从而减少代码重复并提高可维护性，从而支持灵活和可重复使用的授权逻辑。

这些权限检查器通过字符串等匹配权限名称来与 @PermissionsAllowed 一同工作。它们通过评估 SecurityIdentity （代表经过身份验证的用户）和传入的 HTTP 请求参数来支持通用的授权检查。这种方法允许精细访问控制。检查器必须在规范或单例 CDI Bean 中定义，并返回 布尔值 或 Uni<Boolean&gt;，支持同步和重新主动授权检查。

此功能通过集中授权逻辑来简化权限管理，从而可以更轻松地在多个端点之间实施安全策略。开发人员可以创建通用权限检查人员，以动态验证多个操作。

如需更多信息，请参阅"web 端点授权"指南中的创建 权限检查器 部分。

从红帽构建的 Quarkus 3.20 开始，使用 quarkus-oidc 将 OIDC 配置为通过从文件系统中加载 JWT bearer 令牌来验证 OIDC 供应商客户端。

此方法启用安全和自动化身份验证。在容器化环境中（如 OpenShift）特别有用，服务帐户令牌可以挂载为文件。红帽构建的 Quarkus 会自动从文件中加载令牌，并在令牌过期时重新载入令牌。

有关配置详情和使用示例，请查看以下资源：

在红帽构建的 Quarkus 3.20 中，以下 Quarkus 扩展引入了 OpenID Connect (OIDC)响应过滤器。

实施 OidcResponseFilter，以检查响应状态、标头和正文，用于日志记录或其他操作。

默认情况下，OIDC 响应过滤器全局应用。要以特定端点（如令牌端点）为目标，请使用 @OidcEndpoint 注释。

如需更多信息，请参阅"OpenID Connect ( OIDC)身份验证"指南中的 OIDC 响应过滤器 部分。

双向 TLS (mTLS)令牌绑定通过确保访问令牌加密绑定到客户端的 mTLS 身份验证证书来提高安全性。

此功能基于 RFC 8705，通过验证用于身份验证的证书指纹是否与令牌中包含的证书指纹匹配，从而最大程度降低接受 stolen bearer 访问令牌的风险。

从红帽构建的 Quarkus 3.20 开始，Quarkus OIDC 扩展 quarkus-oidc 现在支持用于使用 OpenID Connect (OIDC)和 mTLS 保护的端点的证书绑定访问令牌。

要启用此功能，请设置以下配置属性：

quarkus.oidc.token.binding.certificate=true

quarkus.oidc.token.binding.certificate=true

如需更多信息，请参阅"OpenID Connect (OIDC)身份验证"指南中的 Mutual TLS 令牌绑定 部分。

红帽构建的 Quarkus 3.20 引入了对注入 OidcProviderClient 的支持，允许应用程序与 OpenID Connect (OIDC)供应商的 UserInfo、令牌内省和撤销端点交互。

它使开发人员能够在需要时以编程方式访问 UserInfo、令牌内省和撤销端点。例如，在用户注销后可以撤销访问令牌。

如需更多信息，请参阅 OpenID Connect (OIDC)身份验证指南中的 Token revocation 部分。

从红帽构建的 Quarkus 3.20 开始，使用 quarkus-oidc 开始，您可以使用 OidcTenantConfig 构建器而不是在 application.properties 文件中配置它们，以编程方式定义 OpenID Connect (OIDC)租户。

这个方法比在配置中定义 OIDC 租户提供了更大的灵活性。

这种方法对于需要静态租户的功能特别有用，如基于签发者和基于路径的租户解析器。

如需更多信息，请参阅"OpenID Connect (OIDC)身份验证"指南中的以下资源：

在 Red Hat build of Quarkus 3.20 中，即使 quarkus-oidc 扩展不存在，Keyc 的 Dev Services 也会启动。这个更改可让您隔离测试 quarkus-oidc-client 扩展，而无需完整的 OIDC 扩展。

另外，Red Hat build of Quarkus 现在会在启用了 Keycloak 的 Dev Services 时自动配置密钥 OIDC Client 属性，包括：

在以前的版本中，您必须手动设置这些属性。

这些增强是向后兼容的。现有工作流和手动配置继续按预期工作。

Red Hat build of Quarkus 3.20 现在支持在证书链的 TLS 握手过程中为处理过期或 not-yet-valid 证书配置策略。

在以前的版本中，信任存储允许此类证书没有警告，遵循 RFC 3280 和相关规格。

在这个版本中，用户可以通过选择以下选项之一来控制行为：

在 Red Hat build of Quarkus 3.20 中，quarkus-oidc 扩展现在支持对访问令牌的演示概念验证(DPoP)。

此功能 作为技术预览功能提供。

如需更多信息，请参阅以下资源：

在 Red Hat build of Quarkus 3.20 中，quarkus-tls-registry 扩展引进了对 PEM 密钥存储中加密的 PKCS#8 私钥的支持。

此功能 作为技术预览功能提供。

它使开发人员能够使用 AES-128-CBC 加密保护私钥，从而提高了应用程序安全性。

要使用此功能，请使用密钥存储密码设置 quarkus.tls.key-store.pem.password 属性。

如需更多信息，请参阅使用 TLS Registry 指南管理安全密钥和证书。

使用红帽构建的 Quarkus 3.20，扩展作者可以为在开发模式下运行的应用程序定义 JVM 选项。它们可以指定这些选项，如 --enable-preview or--add-opens 直接在扩展元数据中，无需由应用程序开发人员配置。

在开发模式下运行时，扩展会自动应用这些 JVM 选项，确保所有应用程序开发人员都提供一致的环境。

应用程序开发人员可以关闭所有扩展提供的 JVM 选项，或使用 Quarkus Maven 插件选择性地关闭特定扩展的选项。如需更多信息，请参阅 Quarkus "Quarkus and Maven" 指南中的 Extension provided Dev mode Java options 部分。

从红帽构建的 Quarkus 3.20 开始，Dev UI 页包含一个 HTTP 选项卡，您可以使用它来监控传入的 HTTP 访问日志消息，而无需切换工具或上下文。

例如，如果您在 Dev UI 中使用 SmallRye OpenAPI - Swagger UI 页面与应用程序的 HTTP 端点交互，您可以在 Dev UI footer 的 HTTP 标签页中看到对应的日志消息。

如需更多信息，请参阅 Quarkus " HTTP 参考" 指南中的 配置 HTTP 访问日志 部分。

红帽构建的 Quarkus 3.20 引入了对 Java 记录的支持，作为 REST 端点参数容器，从而启用了简洁和不可变的数据结构。记录可以封装查询、Cookie、标头、表单或多部分参数，简化了 RESTful 服务中的数据处理。

Java 记录已经可用于 JSON 序列化和 REST bodies 的反序列化。但是，由于 Jakarta REST 规格的限制，@BeanParam 尚不支持它们。

在红帽构建的 Quarkus 3.20 中，quarkus-rest 和 quarkus-resteasy 扩展增加了对新的 @AuthorizationPolicy 注解的支持。您可以使用此注解将指定 HttpSecurityPolicy 直接绑定到 Jakarta REST 端点。此功能提供了路径匹配规则的替代选择，并在不修改 SecurityIdentity 角色的情况下启用更灵活的授权检查。

如需更多信息，请参阅"web 端点授权"指南中的 Custom HttpSecurityPolicy 部分。

在红帽构建的 Quarkus 3.20 中，quarkus-rest-client 扩展增加了对 @Url 注释的支持。现在，您可以在 REST 客户端方法中注解参数，以便在运行时动态提供 URL。

通常，REST 客户端需要全局配置的基本 URL。然而，有些情况需要基于每个invocation 来设置 URL。@Url 注释通过为单个调用启用动态 URL 解析来支持这种用例。

如需更多信息，请参阅 Quarkus "使用 REST Client" 指南中的 Dynamic base URL 部分。

在红帽构建的 Quarkus 3.20 中，quarkus-rest-client 扩展已更新至 MicroProfile REST 客户端 4.0。这个版本通过提供用于创建和管理 REST 客户端的标准化声明 API 增强了应用程序与 RESTful 服务交互的方式。它提高了灵活性、性能和安全性，同时简化外部 REST 服务的集成。

在红帽构建的 Quarkus 3.20 中，quarkus-rest-jackson 扩展通过引入 reflection-free deserialization 来增强其 JSON 处理功能。

此增强补充了自由的序列化功能，它在早期版本中实现。

默认情况下，S reflection-free JSON 处理被禁用。要启用它，请将以下配置属性设置为 true ：

quarkus.rest.jackson.optimization.enable-reflection-free-serializers=true

quarkus.rest.jackson.optimization.enable-reflection-free-serializers=true

通过消除反序列化期间反映的依赖，应用程序可以获得更好的性能并降低内存消耗，特别是对于反映可能会引入开销的原生应用程序。如果启用此功能，请运行测试以评估其对应用程序的影响。

如需更多信息，请参阅 Quarkus "Writing REST services with Quarkus REST" 指南中的 JSON serialisation 部分。

红帽构建的 Quarkus 3.20 引入了对 quarkus-websockets-next 扩展的支持，它提供了一个现代的声明性 API 来定义 WebSocket 服务器和客户端端点。

此扩展支持高效、可扩展的实时通信，并与红帽构建的 Quarkus 的被动架构和网络层集成。

与已弃用的 quarkus-websockets 扩展不同，WebSockets Next 不会实现 Jakarta WebSocket 规格。

WebSockets Next 引入的主要功能：

详情请查看 "WebSockets Next reference" 指南中的 Security 部分。

如需更多信息，请参阅 Serialization 和 deserialization 部分。

有关配置详情，请参阅 WebSockets Next 参考指南的 Telemetry 部分。

如需更多信息，请参阅以下资源：

红帽为使用 Quarkus 开发工具提供开发支持，包括 Quarkus CLI 和 Maven 和 Gradle 插件，以设计、开发、测试和部署红帽构建的 Quarkus 应用程序。

红帽不支持在生产环境中使用 Quarkus 开发工具。如需更多信息，请参阅红帽知识库文章 开发支持覆盖范围。

在红帽构建的 Quarkus 3.20 中，以下扩展将 Fabric8 Kubernetes 客户端从版本 6.13 升级到 7.1。

虽然 quarkus-openshift 和 quarkus-kubernetes 扩展使用 Fabric8，但它们的功能保持不变，因此您不需要为它们进行任何更新。

作为升级的一部分，io.quarkus:quarkus-test-openshift-client 模块已被删除。如果您的测试使用此模块，请迁移到 io.quarkus:quarkus-test-kubernetes-client，它提供等同的功能。如需更多信息，请参阅 Quarkus "Kubernetes Client" 指南中的 OpenShift 客户端 部分。

升级的 Fabric8 Kubernetes 客户端重新组织了一些模型类型和类，将部分模式移到不同的模块。要找到它们的新位置，请参阅官方 Fabric8 Kubernetes 客户端：从 6.x 迁移到 7.x 指南。

检查您的应用程序是否有任何受影响的依赖项、配置或 API 使用情况，并根据需要更新它们。然后，对应用程序进行全面的测试，以确保与 Fabric8 7.1 完全兼容。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

在红帽构建的 Quarkus 3.15 中，许多扩展和配置属性被重命名为 RESTEasy Reactive 到 Quarkus REST 和 Reactive Messaging to Quarkus Messaging 的一部分。为了支持这个转换，引入了工件重新定位和配置回退。

在 Red Hat build of Quarkus 3.20 中，这些工件重新定位和配置回退已被删除。现在，您必须使用新的工件名称和配置属性。

如需了解更多背景信息，请参阅 "Release Notes for Red Hat build of Quarkus 3.15" 指南中的 RESTEasy Reactive 扩展重命名为 Quarkus REST 部分。

红帽构建的 Quarkus 3.20 更新区域设置处理，使其与 Mandrel 版本 24.2 及更新版本保持一致。

为确保所有应用程序的一致性区域设置行为，红帽构建的 Quarkus 应用了标准化的默认区域设置策略。使用下表来确定应用程序的行为根据您的区域设置变化。

en_US 区域总是嵌入到原生可执行文件中，无论 quarkus.locales 配置是什么。

检查应用程序在配置属性中的区域设置，如有必要，更新设置以避免行为的意外更改。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

在红帽构建的 Quarkus 3.20 中，@Fallback.fallbackMethod （） 和 @BeforeRetry.methodName （） 的配置属性现在在构建时被解决，且无法在运行时更改。受影响的配置属性有：

此更改可确保正确反映配置和与原生镜像编译的兼容性。

在 Red Hat build of Quarkus 3.20 中，quarkus-smallrye-fault-tolerance 扩展包括 SmallRye Fault Tolerance 6.7.0，它没有破坏更改，但包括以下更新：

如需更多信息，请参阅 SmallRye Fault Tolerance 6.7.0 发行公告，其中包括到 programmatic API 迁移指南的链接，以及新配置属性的详情。Quarkus SmallRye Fault Tolerance 指南为这些配置属性提供了完整的参考。

从红帽构建的 Quarkus 3.20 开始，io.quarkus.scheduler.Scheduler 中的方法行为已更改。

当调度程序没有启动时，几乎所有方法现在都会抛出 UnsupportedOperationException。

要验证调度程序是否正在运行，您可以使用新方法 Scheduler#isStarted （）。

这个更改会影响来自 quarkus-scheduler 和 quarkus-quartz 扩展的调度程序实例。

从红帽构建的 Quarkus 3.20 开始，当您使用 development 和 test 模式时，管理界面默认侦听 localhost 接口，而不是 0.0.0.0。这个变化与主接口的行为一致。

在 Windows 上，适用于 Linux (WSL)的 Windows 子系统，管理和主接口将继续侦听 0.0.0.0。

如需更多信息，请参阅 Quarkus 管理界面参考指南。

在红帽构建的 Quarkus 3.20 中，配置已迁移到 @ConfigMapping 框架。这个更改弃用了旧的配置类，而是基于接口和方法签名的统一配置模型。

对于某些常用的配置类，兼容性层仍存在，但计划在以后的发行版本中删除。

从红帽构建的 Quarkus 3.20 开始，红帽构建器和运行时基础镜像已升级到使用 Red Hat Universal Base Image 9 (UBI 9)。

当从 UBI 8 升级到 UBI 9 时，请注意，系统依赖项、原生镜像构建或软件包和 GNU C 库(glibc)版本更新可能会影响应用程序的行为或运行时环境。根据需要检查和更新您的配置。

如果 UBI 9 时遇到问题，您可以手动切换到使用 UBI 8：

如需更多信息，请参阅以下资源：

在早期版本的 Red Hat build of Quarkus 中，当 Dev Services 被禁用或以 production 模式运行时，quarkus.datasource.reactive.url 和 quarkus.datasource.<datasource-name>.reactive.url 属性被隐式设置为未记录的默认，以带有数据库特定端口的 localhost 为目标。

从红帽构建的 Quarkus 3.20 开始，这些属性在禁用 Dev Services 时不再具有默认值，或者应用程序以 production 模式运行。如果没有设置属性，则会取消激活对应的数据源。如果应用程序尝试使用已停用的数据源，它将在启动时失败。详情请查看 Datasource usage failed if data is deactivated 或 no URL set release note。

如果您的应用程序需要活跃的数据源，并且希望它连接到 localhost 上的数据库，则必须明确设置 quarkus.datasource.reactive.url 或 quarkus.datasource.<datasource-name>.reactive.url 属性。例如：

quarkus.datasource.reactive.url=postgresql://localhost:5432/mydatabase

quarkus.datasource.reactive.url=postgresql://localhost:5432/mydatabase

在早期版本中，此配置被隐式设置。从这个版本开始，您必须定义用于激活数据源的 URL。

在以前的版本中，当 Dev Services 被禁用或生产模式中，红帽构建的 Quarkus 也会为数据源提供健康检查，即使 quarkus.datasource.jdbc.url, quarkus.datasource.<datasource.<datasource-name>.jdbc.url,quarkus.datasource.reactive.url, 或 quarkus.datasource.<datasource-name>.reactive.url 属性没有设置。这会导致对 JDBC 数据源成功进行不可靠的健康检查，对于被动数据源，几乎始终失败。

从红帽构建的 Quarkus 3.20 开始，没有 URL 的数据源不再贡献健康检查。为确保健康检查可用，请明确设置 quarkus.datasource.jdbc.url, quarkus.datasource.<datasource-name>.jdbc.url ,quarkus. datasource.reactive.url, 或 quarkus.datasource.<datasource.<datasource.<reactive.url 属性。

在 Red Hat build of Quarkus 3.20 中，即使数据源使用 quarkus.datasource.active=false 取消激活或缺少 URL，应用程序也会成功启动。当数据源首次访问时，通常会造成运行时失败，特别是在 Dev 服务被禁用或生产模式中时。

在这个版本中，如果红帽构建的 Quarkus 检测到使用了数据源，但会被取消激活或缺少 URL，则应用程序无法启动。

红帽构建的 Quarkus 现在在启动时强制执行更严格的验证，以便在早期捕获这些问题：

相同的验证适用于其 Flyway 和 Liquibase 的扩展，用于其 Flyway 和 LiquibaseFactory CDI Bean。

在 Red Hat build of Quarkus 3.20 中，quarkus-flyway 扩展将 Flyway 升级到版本 11，这会删除 cleanOnValidationError 配置参数。另外，调用 Flyway.validate （） 不再在验证错误时清除。

为了缓解这个变化，红帽构建的 Quarkus 3.20 引入了 quarkus.flyway.validate-at-start.clean-on-validation-error 配置属性，它提供与 cleanOnValidationError 类似的行为，但仅在应用程序启动时应用。

临时解决方案：如果您在明确调用 Flyway.validate （） 中需要之前 清理Error 的行为，请考虑捕获应用程序中验证错误，并使用 Flyway.clean （） 显式触发数据库清理。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

如需更多信息，请参阅使用 Flyway 指南 的 Quarkus。

在 Red Hat build of Quarkus 3.20 中，Dev Services 使用的 IBM Db2 驱动程序和容器镜像已升级到 12 版本。

迁移应用程序到红帽构建的 Quarkus 3.20 指南中描述的自动更新将 IBM Db2 驱动程序和容器镜像升级到 12 版本。

查看 在升级到 Db2 Connect 12.1 驱动程序时有关 IBM 功能更改 的新许可证要求、配置步骤和 SSL/TLS 设置，以升级到 Db2 Connect 12.1。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

在红帽构建的 Quarkus 3.20 中，Hibernate ORM 的 Bean Validation 集成的默认行为发生了变化。在以前的版本中，在数据定义语言(DDL)生成过程中不会考虑验证约束。在这个版本中，Hibernate ORM 默认在 DDL 中包括适用的验证限制，确保数据库模式与应用程序级别约束更加一致。

quarkus.hibernate-orm.validation.enabled 属性也已弃用。

有关迁移应用程序的这些更改和指南的更多信息，请参阅 迁移指南 3.19 或以下资源：

在 Red Hat build of Quarkus 3.20 中，quarkus.log aws.json 配置属性已弃用。要为日志记录启用 JSON 格式，请使用 quarkus.log aws.json.enabled 属性。

引进了这个更改来提高与 YAML 配置的兼容性，以前的结构需要使用特殊语法（如 ~ ）为 root 键分配值，从而导致混淆或容易出错的设置。

如需更多信息，请参阅 迁移指南 3.19。

在 Red Hat build of Quarkus 3.20 中，quarkus-opentelemetry 扩展引入了破坏更改，因为一些数据库出现的问题（如与 Redis 相关的值）被移到不同的软件包中。

OpenTelemetry 不维护数据库语义惯例的更改列表，因为它们尚不稳定。

如果您使用手动工具，可能需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

在 Red Hat build of Quarkus 3.20 中，之前弃用的 quarkus-smallrye-opentracing 扩展和相关配置属性 quarkus.datasource.jdbc.tracing 已被删除。

quarkus-opentelemetry 扩展现在是首选的追踪解决方案。要使用 OpenTelemetry 启用 JDBC 追踪，请使用以下配置属性：

quarkus.datasource.jdbc.telemetry=true

quarkus.datasource.jdbc.telemetry=true

要迁移，请将 OpenTracing 扩展替换为 OpenTelemetry，并相应地更新您的配置。

从 Red Hat build of Quarkus 3.20 开始，如果您使用 quarkus-oidc-client 扩展，但没有将 OpenID Connect (OIDC)客户端配置为指向特定 URL，则 Keycloak 的 Dev Services 会自动以 dev 模式启动。

要禁用此行为，请在 application.properties 文件中添加以下属性：

quarkus.keycloak.devservices.enabled=false

quarkus.keycloak.devservices.enabled=false

在 Red Hat build of Quarkus 3.20 中，使用 WebAuthn4J 重新实施 quarkus-security-webauthn 扩展来增强安全性、与行业标准一致，并改进长期可维护性。

因此，这个更新与之前的扩展版本不兼容。

要平稳过渡到新实施，请使用以下信息：

此功能的状态从 preview 降级为 实验性，以允许进一步稳定。

如需更多信息，请参阅 Using Security with WebAuthn 指南。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

在以前的版本中，红帽构建的 Quarkus 3.15 版本附带 @WithTestResource 版本被缺陷，因此没有宣布。

在 Red Hat build of Quarkus 3.20 中，这个问题已解决。在本发行版本中，早期 restrictToAnnotatedClass 字段已被 scope 替代。

在早期版本中，quarkus-junit5-mockito 依赖项被配置为使用 子类 模拟策略来创建模拟对象。

从红帽构建的 Quarkus 3.20 开始，依赖项现在被配置为默认 使用内联 模拟策略。

在 Red Hat build of Quarkus 3.20.0 中，quarkus-junit5-mockito 依赖项因为依赖项版本中有有意不匹配而临时无法正常工作。Mockito 的版本使用所需的 JUnit 5.11 或更高版本，但平台包含 JUnit 5.10。

要解决这个问题，红帽构建的 Quarkus 3.20.1 将 JUnit 升级到 5.12.1 版本。这个版本与 JUnit 和 Mockito 的版本一致，并恢复 quarkus-junit5-mockito 依赖项的兼容性。

此更新的影响应该最少。社区和 Camel Quarkus 中的测试没有显示任何回归问题。如需更多信息，请参阅相关问题 ：https://github.com/quarkusio/quarkus/issues/46858。

为确保所有 JUnit 工件的一致性，请导入 3.20.0 中使用的 JUnit BOM 版本，如下所示：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.junit</groupId>
      <artifactId>junit-bom</artifactId>
      <version>5.10.5</version>
      <scope>import</scope>
      <type>pom</type>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.junit</groupId>
      <artifactId>junit-bom</artifactId>
      <version>5.10.5</version>
      <scope>import</scope>
      <type>pom</type>
    </dependency>
  </dependencies>
</dependencyManagement>

如果启用了 HTTP 压缩，quarkus.http.compress-media-types 配置属性定义要压缩的介质类型列表。在 Red Hat build of Quarkus 3.20 中，此属性的默认值已更改。新压缩的介质类型现在包含 application/json 和 application/xhtml+xml。

在 Red Hat build of Quarkus 3.20 中，REST 客户端配置更为严格，以减少检索配置所需的查找和组合数量：

从红帽构建的 Quarkus 3.20 开始，quarkus-qute 扩展会自动转义双引号(")、反斜杠(\)，如果设置了对应的模板变体，则 JSON 模板中的U+0000 到 U+001F）。扩展会自动为 src/main/resources/templates 目录中的模板分配一个变体。

默认情况下，java.net.URLConnection#getFileNameMap （） 决定模板文件的内容类型。您可以使用 quarkus.qute.content-types 配置来定义额外的后缀到内容类型映射。

要呈现未转义的值，请使用 raw 或 secure 属性，它们作为 java.lang.Object 的扩展方法实现，或者在 io.quarkus.qute.RawString 类中嵌套字符串值。

如需更多信息，请参阅 Quarkus "Qute 参考" 指南中的 Character escapes 部分。

在带有 quarkus-rest-jackson 扩展的 Quarkus 3.20 中，只有 ObjectMapperCustomizer Bean 应用到 Jackson JSON 处理器的默认 ObjectMapper 实例。

在早期版本中，所有自定义器 Bean （包括带有自定义限定符）都应用到默认的 ObjectMapper 实例。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

如需更多信息，请参阅以下资源：

在以前的版本中，使用 quarkus-rest 扩展，带有空值的查询参数（如 ?foo= ）被反序列化，如下所示：

在 Red Hat build of Quarkus 3.20 中，此行为已更改：

相应地更新您的代码。

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。

红帽构建的 Quarkus 3.20 弃用 quarkus-websockets 和 quarkus-websockets-client 扩展，该扩展实现了 Jakarta WebSocket 规格。

Red Hat build of Quarkus 计划在以后的发行版本中停止支持这些扩展。

为确保与即将推出的版本兼容，请迁移到 Quarkus WebSockets Next 扩展quarkus-websockets-next，它提供现代、效率更高的 WebSocket API。

如需更多信息，请参阅以下 Quarkus 资源：

这个更改需要手动干预。它不包括在 将应用程序迁移到红帽构建的 Quarkus 3.20 指南中的自动更新过程中。