红帽构建的 Quarkus 3.8 发行注记

Java 21 现在是推荐的版本，但支持 Java 17。

在这个 3.8 发行版本中，删除了对版本 3.2 中弃用的 Java 11 的支持。

使用带有虚拟线程(VT)的 Red Hat build of Quarkus 会有以下几项：

虚拟线程限制：

在红帽构建的 Quarkus 3.8 中，Hibernate Object-Relational Mapping (ORM)升级到 6.4 版本。

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

在红帽构建的 Quarkus 3.8 中，Hibernate Reactive 可以与 Agroal 共存，这意味着您可以在应用程序中使用 Flyway 或 Liquibase，同时将 Hibernate Reactive 用作对象-Relational Mapping (ORM)。

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

在 Red Hat build of Quarkus 3.8 中，Hibernate Reactive 扩展升级到版本 2.2，它与 Hibernate ORM 6.4.0 兼容。

如需更多信息，请参阅 Hibernate Reactive 2.2.0 文档。

在 Red Hat build of Quarkus 3.8 中，Hibernate Search 被升级到 7.0 版本。

Hibernate Search 向红帽构建 Quarkus 应用程序提供索引和全文本搜索功能。版本 7.0 引入了对 geo-point 字段的默认配置的改进、新功能以及一些显著变化。

如需了解更多详细信息，请参阅 影响与早期版本的兼容性的更改。

要了解更多有关 Hibernate Search 7.0 的信息，请参阅以下资源：

Red Hat build of Quarkus 3.8 引入了一个新的 OpenSearch Dev Service。

当您使用 Hibernate Search 时，Dev Services 默认为根据 Hibernate Search 配置启动 Elasticsearch 或 OpenSearch。

要将 Dev Services 配置为使用 OpenSearch，请指定以下设置：

quarkus.elasticsearch.devservices.distribution=opensearch

如需更多信息，请参阅 Quarkus "Dev Services for Elasticsearch" 指南中的 配置 镜像部分。

红帽构建的 Quarkus 3.8 引进了许多使用作为上下文和依赖注入(CDI) Bean 实施的新 MeterRegistryCustomizer 接口来自定义 Micrometerterter 的方法。

您可以使用以下方法自定义 Micrometer ：

如需更多信息，请参阅 Quarkus " Micrometer Metrics" 指南中的自定义 Micrometer 部分。

Micrometer 定义两个注释，@Counted 和 @Timed，您可以添加到方法中。

使用红帽构建的 Quarkus 3.8，微主题器可将 @Meter 注释添加到标上 @Counted 和 @Timed 的方法的参数。

@MeterTag 注释使用 io.micrometer.common.annotation 软件包中的 ValueResolver 或 ValueExpressionResolver 解析器动态地为方法计数器或计时器分配额外的标签值。

如需更多信息，请参阅 Quarkus Micrometer Metrics 指南。

红帽构建的 Quarkus 3.8 引入了对从 Micrometer 指标库收集 Netty 分配器指标的支持。

引入了 quarkus.micrometer.binder.netty.enabled 属性，允许在启用了 Micrometer 支持时收集 Netty 指标。

Netty 分配器指标可以深入了解您的 Netty 框架内的内存分配和使用，这有助于了解使用 Netty 的红帽构建的 Quarkus 应用程序的性能。

收集以下指标：

有关 Micrometer 的更多信息，请参阅 Quarkus Micrometer 指标 指南。

在 Red Hat build of Quarkus 3.8 中，OpenTelemetry (OTel)扩展 quarkus-opentelemetry 被改进，将默认的 OTel exporter 替换为基于 Vert.x 构建的 Quarkus 实现。

这消除了对 OkHttp 库的依赖项。导出器仍然会自动与上下文和依赖注入(CDI)连接，因此 quarkus.otel.traces.exporter 属性默认为 cdi。

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

使用红帽构建的 Quarkus 3.8，如果其内容大小超过 4KB，您可以将 OpenID Connect (OIDC)会话 Cookie 分成较小的 Cookie。

通常，默认情况下，会话 Cookie 由三个令牌连接组成，包括三个令牌，即 ID、访问和刷新令牌。如果它的大小大于 4KB，一些浏览器可能无法处理它。

在这个版本中，一个超过 4KB 的会话 Cookie 会自动分成多个块。

如需更多信息，请参阅 用于保护 Web 应用程序的 Quarkus OIDC 授权代码流机制。

使用红帽构建的 Quarkus 3.8，您可以在 HTTP 请求完成后为身份验证目的创建 OIDC SecurityIdentity 实例。

在这个版本中，quarkus-oidc 扩展包括 io.quarkus.oidc.TenantIdentityProvider 接口，您可以注入并调用在 HTTP 请求完成后将令牌转换为 SecurityIdentity 实例。

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

Red Hat build of Quarkus 3.8 引入了 OIDC JavaScriptRequestChecker bean，可用于自定义 JavaScript 请求检查。

如果您使用带有红帽构建的 Quarkus Web 应用的单页应用程序(SPAs)和 JavaScript API，如 Fetch 或 XMLHttpRequest(XHR)，您必须在浏览器脚本中设置标头，将请求标识为 JavaScript 请求。但是，脚本引擎也可以设置特定于引擎的请求标头本身。

在这个版本中，您可以注册自定义 io.quarkus.oidc.JavaScriptRequestChecker bean，它会在当前请求是 JavaScript 请求时通知 Red Hat build of Quarkus，这有助于避免创建冗余标头。

Red Hat build of Quarkus 3.8 引入了对延迟 OIDC JSON Web 密钥(JWK)解析的支持，您现在可以解决当前令牌可用的密钥。

此发行版本添加了 quarkus.oidc.jwks.resolve-early 配置属性。默认情况下，此属性设置为 true，这意味着当您建立 OIDC 供应商连接时，JWK 密钥会解决。

但是，您可以将其设置为 false，同时启用密钥延迟解析令牌验证。延迟 JWK 解析在初始化时使用当前令牌而不是读写方法。例如，令牌可能会提供有关如何正确解析密钥的信息。

当将 mTLS 客户端身份验证(quarkus.http.ssl.client-auth)设置为 required 时，Red Hat build of Quarkus 会自动禁用普通的 HTTP 端口，以确保只接受安全 HTTPS 请求。要启用普通的 HTTP，请将 quarkus.http.ssl.client-auth 配置为 请求 或设置 quarkus.http.ssl.client-auth=required 和 quarkus.http.insecure-requests=enabled。

Red Hat build of Quarkus 已更新，允许运行时配置 HTTP 权限和角色，跨配置集启用灵活的安全设置。这解决了原生可执行文件锁定到构建时安全配置的问题。现在，针对每个配置文件动态调整安全性，适用于 JVM 和原生模式。

如果您在红帽构建的 Quarkus 中使用 Bearer 令牌身份验证，您可以从验证的 JWT 访问令牌中映射 SecurityIdentity 角色。Red Hat build of Quarkus 3.8 引入了将 OIDC scope 参数映射到 SecurityIdentity 对象的权限的功能。

例如，您可以使用 @PermissionAllowed ("orders_read") 来请求 JWT 令牌具有 orders_read 值的范围声明。

如需更多信息，请参阅 Quarkus OIDC Bearer 令牌身份验证 指南。

使用红帽构建的 Quarkus 3.8，您可以使用上下文和依赖注入(CDI)来观察身份验证和授权安全事件。

CDI 观察程序可以是同步或异步的，并支持以下安全事件的报告：

如需更多信息，请参阅 Quarkus"安全提示和技巧"指南中的 观察安全事件 部分。

Red Hat build of Quarkus 3.8 引入了对 OpenID Connect (OIDC)授权代码流的支持。

当 OIDC 授权服务器发出一个 ID 令牌以响应授权请求时，ID 令牌包含一个 非ce 声明，它必须与非ce 身份验证请求查询参数匹配。此功能通过确保返回 ID 令牌来响应原始授权请求，且不是重播响应，这有助于缓解重播攻击。

使用红帽构建的 Quarkus 3.8，您可以通过注册一个或多个 OidcRequestFilter 实现来自定义由 quarkus-oidc-client 或 quarkus-oidc 扩展提供的 OIDC 客户端请求。

例如，OIDC 请求过滤器可以分析请求正文，并将其摘要添加为新的标头值。

如需更多信息，请参阅 Quarkus "OIDC authorization code flow mechanism for protect web application" 指南中的 OIDC request filters 部分。

在红帽构建的 Quarkus 3.8 中，引入了一个新的 @TenantFeature 注解，将 OpenID Connect (OIDC)功能绑定到 OIDC 租户。

io.quarkus.oidc.Tenant 注解现在用于解析租户配置。

红帽构建的 Quarkus 3.8 引入了对 OIDC 令牌传播的支持。

在这个版本中，红帽构建的 Quarkus 端点使用 REST 客户端将传入的 OIDC 访问令牌传播到预期访问令牌的其他安全端点。

在使用 Mutual TLS (mTLS)身份验证机制时，红帽构建的 Quarkus 3.8 现在支持将通用名称(CN)属性从客户端的 X.509 证书映射到角色。此功能在特定条件下激活：

此功能在特定条件下激活：

角色映射文件应该具有 CN=role1,role,…​,roleN 格式，并使用 UTF-8 进行编码。

Red Hat build of Quarkus 3.8 引入了使用令牌中内联的 X.509 证书链来验证 OIDC bearer 访问令牌。

这意味着，您在从叶证书中提取公钥前验证证书链。leaf 证书指的是 X.509 证书，它位于证书链的末尾。要验证令牌的签名，您可以使用这个公钥。

Quarkus 更新 现在支持 OpenRewrite recipes 用于外部红帽构建的 Quarkus 扩展，使其功能只扩展超过内置扩展的功能。引进了新的方法，增强对外部扩展的迁移支持。

请注意，红帽支持使用 Quarkus 开发工具的开发支持，包括 Quarkus CLI 以原型、开发、测试和部署 Quarkus 应用程序的红帽构建。https://access.redhat.com/support/offerings/developer/红帽不支持在生产环境中使用 Quarkus 开发工具。

使用 quarkus-info 的应用程序现在可以通过 CDI 集成通过额外的数据增强 /info 端点。此功能增强了自定义和扩展应用程序诊断和元数据可见性的功能。

使用红帽构建的 Quarkus 3.8，REST 客户端的服务器事件(SSE)功能得到了增强，启用完整的事件返回和过滤。REST 客户端中的这些更新和新描述为开发人员提供了管理实时数据流的控制和灵活性。

使用红帽构建的 Quarkus 3.8，您可以在使用 rest-client-reactive-jackson 扩展时自定义 ObjectMapper。您可以使用注解 @Client ObjectMapper 添加仅客户端使用的自定义 ObjectMapper。

如需更多信息，请参阅 Quarkus "Using the REST client" 指南中的自定义 ObjectMapper in REST Client Reactive Jackson 部分。

@TestHTTPResource 注释现在支持路径参数。由于 URI 格式的不合规，不再应用作为 URI 字符串的验证。

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

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

您不再使用以前的配置名称 stork."service-name".load-balancer 和 quarkus.stork."service-name".load-balancer 来配置 Stork 负载均衡器。反之，使用 quarkus.stork."service-name".load-balancer.type 进行配置。

OkHttp 和 Okio 已从 Quarkus Platform BOM 中删除，它们的版本不再被强制执行，从而解决了与过时的依赖项相关的问题。这个更改会影响测试框架依赖项，并简化了运行时依赖项。使用这些依赖项的开发人员现在在构建文件中指定其版本。另外，quarkus-test-infinispan-client 工件已被删除，因为对 Infinispan 提供强大的 Dev Services 支持。

从此版本 Red Hat build of Quarkus 开始，删除了对 Java 11 的支持（在以前的版本中被弃用）。Java 21 现在是推荐的版本，但支持 Java 17。

在红帽构建的 Quarkus 中，将 RESTEasy Reactive 与 XML Binding (JAXB)的 Java 架构搭配使用，不支持将集合、数组和映射用作 REST 方法中的参数或返回类型。为克服 JAXB 的这一限制，请在带有 @XmlRootElement 的类内封装这些类型。

在静态初始化阶段，红帽构建的 Quarkus 会收集要注入 CDI Bean 的配置。然后，收集的值会与其运行时初始化对应的部分进行比较，如果检测到不匹配，应用程序启动会失败。使用红帽构建的 Quarkus 3.8，您现在可以使用 @io.quarkus.runtime.annotations.StaticInitSafe 注解来告知用户注入的配置：

模板中的用户标签现在默认以隔离方式执行，从而限制对调用模板的上下文的访问。在这个版本中，可以在标签模板中更改数据处理，可能会影响其当前功能。要绕过此隔离并保持对父上下文的访问权限，请在标签调用中包含 _isolated=false 或 _unisolated，例如：NT itemDetail item showImage=true _isolated=false。这种方法允许标签从父上下文访问数据，如以前一样。此更改可最小化从父上下文到标签的意外数据暴露，从而增强模板数据完整性。但是，可能需要对现有模板的依赖共享上下文访问更新，代表一个显著的更改，可能会影响与这种隔离机制不熟悉的用户。

ResultNode 类已更新为抽象类，而不是接口，尽管在公共 API 中不应该被用户实现。Qute API 现在将 CompletionStage 实现限制为 java.util.concurrent.CompletableFuture 和 io.quarkus.qute.CompletedStage，这是可通过 -Dquarkus.qute.unrestricted-completion-stage-support=true 的一个限制。

在 Red Hat build of Quarkus 3.8 中，以下 quarkus-rest-client 扩展被重命名：

@TestHTTPResource 注释现在支持路径参数。由于 URI 格式的不合规，不再应用作为 URI 字符串的验证。

GraalVM SDK 版本在 Red Hat build of Quarkus 3.8 中已更新至 23.1.2。使用需要 GraalVM 替换扩展的开发人员应该从 org.graalvm.sdk:graal-sdk 切换到 org.graalvm.sdk:nativeimage 以访问必要的类。对于使用 org.graalvm.js:js 的用户，请将这个依赖项替换为 org.graalvm.polyglot:js-community 用于社区版本。对于企业版本，请将此依赖项替换为 org.graalvm.polyglot:js。使用 quarkus update 自动调整 graal-sdk。但是，必须手动更改 js 依赖项。虽然这个变化不太可能，但这个更改可能会影响依赖的用户：

在本发行版本中，QuarkusComponentTest 有几个调整。它仍然是实验性的，不受 Red Hat build of Quarkus 支持。此实验状态表示 API 可能会随时更改，以反映收到的反馈。

QuarkusComponentTestExtension 现在不可变，需要通过简化的 constructor QuarkusComponentTestExtension (Class…) 或 QuarkusComponentTestExtension.builder （） 方法进行编程注册。测试实例生命周期（可以是 Lifecycle#PER_METHOD （默认）或 Lifecycle#PER_CLASS 规定，决定 CDI 容器何时启动和停止； PER_METHOD 会在每个测试后启动容器并停止它，而 PER_CLASS 在所有测试之前都会启动它，并在所有测试后停止它。这代表了之前版本的变化，容器总是在所有测试之前启动并停止。

在红帽构建的 Quarkus 3.8 中，Hibernate Object-Relational Mapping (ORM)已升级到版本 6.4，并引进了以下破坏更改：

如需更多信息，请参阅 Hibernate ORM 6.4 迁移指南。

在 Red Hat build of Quarkus 3.8 中，Hibernate Search 被升级到 7.0 版本，并引入了以下破坏更改：

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

SQL Server 的 dev Services 将其默认镜像从 mcr.microsoft.com/mssql/server:2019-latest 更新至 mcr.microsoft.com/mssql/server:2022-latest。

首选使用 Red Hat build of Quarkus " Configure data sources" 指南中的 config 属性来指定替代方案。

在 Red Hat build of Quarkus 3.8 中，Flyway 扩展被升级到 Flyway 9.20.0，它为 Oracle 用户提供额外的依赖项 flyway-database-oracle。

Oracle 用户必须更新 pom.xml 文件，使其包含 flyway-database-oracle 依赖项。要做到这一点，请执行以下操作：

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-database-oracle</artifactId>
</dependency>

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-database-oracle</artifactId>
</dependency>

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

quarkus-bom 中的 Kafka 扩展的 Strimzi OAuth 支持现在使用 io.strimzi:strimzi-kafka-oauth 版本 0.14.0，引入一个已知问题，导致原生构建失败。'io.smallrye.reactive.kafka.graal.Target_com_jayway_jsonpath_internal_DefaultsImpl 的错误不会被加载，方法是将 io.strimzi:kafka-oauth-common 添加到项目的 classpath 中。

当在 Quarkus 3.8 中使用 Opentelemetry (oTel)检测时，您现在可以使用 io.opentelemetry.instrumentation.annotations.AddingSpanAttributes 注解来在任何上下文依赖注入(CDI)-aware bean 中添加注解的方法。

如需更多信息，请参阅 Quarkus "Using OpenTelemetry" 指南中的 CDI 部分。

使用红帽构建的 Quarkus 3.8 时，quarkus-smallrye-metrics 扩展不再被支持。现在，它只作为社区扩展提供。不建议在生产环境中使用它。

在 Red Hat build of Quarkus 3.8 中，quarkus-smallrye-metrics 被完全支持的 quarkus-micrometer 扩展替代。

使用红帽构建的 Quarkus 3.8 时，不再支持 SmallRye OpenTracing。要继续使用分布式追踪，请将您的应用程序迁移到 SmallRye OpenTelemetry，现在在这个发行版本中被完全支持，不再是一个技术预览功能。如果您仍然需要使用 quarkus-smallrye-opentracing，请通过更新 groupId 并手动指定版本，调整应用程序以使用 Quarkiverse 中的扩展。

在 Red Hat build of Quarkus 3.8 中，已重构 OpenTelemetry Tracing 和 quarkus-scheduler 扩展的集成。

在此次更新之前，只有 @Scheduled 方法具有一个新的 io.opentelemetry.api.trace.Span 类，该类在启用追踪时自动关联。也就是说，当 quarkus.scheduler.tracing.enabled 配置属性设为 true 时，quarkus-opentelemetry 扩展可用。

在这个 3.8 发行版本中，所有调度的作业（包括以编程方式调度的作业）在启用追踪时自动关联 Span。每个调度方法的唯一作业标识符都是生成的，通过设置 io.quarkus.scheduler.Scheduled#identity 属性或使用 JobDefinition 方法来指定。在此次更新之前，范围名称后是 < simpleclassname>.<methodName> 格式。

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

当将 mTLS 客户端身份验证(quarkus.http.ssl.client-auth)设置为 required 时，Red Hat build of Quarkus 会自动禁用普通的 HTTP 端口，以确保只接受安全 HTTPS 请求。要启用普通的 HTTP，请将 quarkus.http.ssl.client-auth 配置为 请求 或设置 quarkus.http.ssl.client-auth=required 和 quarkus.http.insecure-requests=enabled。

JWT 扩展不再依赖于主动路由扩展。如果您的应用程序同时使用 JWT 和 Reactive Routes 功能，但没有声明对 Reactive Routes 的明确依赖项，您必须添加此依赖项。

因为更新到 Keycloak 22.0.0 及其对扩展功能的更新，quarkus-keycloak-authorization 扩展不再包含 org.keycloak:keycloak-adapter-core 依赖项。在以后的 Keycloak 版本中，计划删除 Keycloak Java 适配器代码。如果您的应用程序需要这个依赖项，请手动将它添加到项目的 pom.xml 中。

您不再使用 Context 和 Dependency Injection (CDI)注解和拦截器来解析 RESTEasy Classic 应用的租户 OIDC 配置。

由于在 CDI 拦截器和需要身份验证的检查之前强制进行安全检查，使用 CDI 拦截器解析多个 OIDC 供应商配置标识符不再可以正常工作。

使用 @Tenant 注释或自定义 io.quarkus.oidc.TenantResolver。

如需更多信息，请参阅 Quarkus" 使用 OIDC 多租户指南"中的解决注解 部分。

在 Red Hat build of Quarkus 3.8 中，现在使用 quarkus.oidc.TenantFeature 注解而不是 quarkus.oidc.Tenant 将 OpenID Connect (OIDC)功能绑定到 OIDC 租户。

quarkus.oidc.Tenant 注解现在用于解析租户配置。

Red Hat build of Quarkus 3.8 允许运行时配置 HTTP 权限和角色，跨配置集启用灵活的安全设置。这解决了原生可执行文件锁定到构建时安全配置的问题。现在，针对每个配置文件动态调整安全性，适用于 JVM 和原生模式。

已修正了基于注解的 GraphQL 指令的应用程序，以确保它们只应用于声明它们的 schema 元素类型。

例如，如果声明了一个指令应用到 GraphQL 元素类型 FIELD，但错误地应用到不同的元素类型，它仍然在不应该适用的元素的 schema 中可见，从而导致一个无效的模式。现在，这个问题已被修正，指令会根据其适用性声明进行了检查。

如果您以这种方式应用了指令，它们将不再出现在架构中，红帽构建的 Quarkus 3.8 会在构建期间记录警告。

红帽构建的 Quarkus 3.8 增强了其 REST 客户端的 Server-Sent Events (SSE)功能，从而实现了完整的事件返回和过滤。REST 客户端中的这些更新和新描述为开发人员提供了管理实时数据流的控制和灵活性。

在版本 3.8 之前，红帽构建的 Quarkus SmallRye JWT 会自动纳入 quarkus-reactive-routes，此功能从版本 3.8 开始停用。为确保继续功能，请手动添加 quarkus-reactive-routes 作为构建配置中的依赖项。