1.7. 影响与早期版本兼容性的更改

您不再使用以前的配置名称 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 作为构建配置中的依赖项。