红帽构建的 Quarkus 3.2 发行注记

在红帽构建的 Quarkus 3.2 中，Qte template 引擎得到了改进，可以缓存很少更改的模板的那些部分，这有助于提高效率。

要使用缓存的小节功能，请使用 quarkus-cache 扩展，其中 CacheSectionHelper 被自动注册和配置。

如需更多信息，请参阅"Qute reference"指南中的 Cached 部分。

红帽构建的 Quarkus 中的 Kubernetes 客户端已 从版本 5.12 升级到 6.7.2。此升级为开发云原生应用程序提供了增强的功能和改进支持。如需更多信息，请参阅 Kubernetes 客户端 - 从 5.x 迁移到 6.x 指南。

红帽构建的 Quarkus 3.2 引入了构建时分析功能。此功能提供有关应用程序构建期间红帽构建的 Quarkus 的使用信息，而不是在运行时期间使用。

使用分析报告提供了匿名信息，如使用哪些操作系统、JAVA 版本、构建系统和扩展。使用分析可帮助红帽更好地了解红帽构建的 Quarkus 是如何改进的。

要选择，请在 dev 模式下运行红帽构建的 Quarkus。您第一次这样做时，会询问您是否希望选择向 Quarkus 社区贡献匿名构建时间数据。当您运行红帽构建的 Quarkus 应用程序中（例如，在生产环境中）时，不会收集这些数据。

如需更多信息，请参阅 Quarkus 社区中的 Quarkus 使用分析 指南。有关收集哪些数据的更多信息，请参阅 Telemetry 数据收集通知。

红帽构建的 Quarkus Infinispan 扩展现在支持声明性缓存 API，允许在 CDI 管理的 Bean 中基于注解的缓存控制。

管理网络接口是管理和监控应用程序的专用频道，包括为各种管理任务（如健康检查和指标）提供端点。

大多数 quarkus-cache 扩展配置已被运行时，允许您在应用程序启动时定义缓存配置。某些配置属性可以在运行时通过 API 调用来更改。

有些应用程序要求电子邮件通过不同的 SMTP 服务器发送。在红帽构建的 Quarkus 3.2 中，您现在可以使用多个 SMTP 服务器配置多个邮件者并发送电子邮件。

如需更多信息，请参阅" 邮件参考"指南中的多邮件器配置部分。

红帽构建的 Quarkus 3.2 对开发 UI 进行了重大更改和增强，包括用于简化在开发期间管理和监控应用程序组件的图形界面。这有助于有效地进行日志导航、指标跟踪和端点管理。

使用红帽构建的 Quarkus 3.2 版本，您可以使用新的调度程序程序 API 以编程方式调度作业。

要以编程方式调度作业，您可以注入 io.quarkus.scheduler.Scheduler。您还可以删除以编程方式计划的作业。

如需更多信息，请参阅 Quarkus "Scheduler reference" 指南中的 Programmatic scheduling 部分。

Red Hat build of Quarkus 更新工具通过自动更新项目依赖项、配置和代码来简化应用程序的升级，以匹配最新的红帽构建的 Quarkus 版本。它简化了迁移过程，确保兼容性并减少保持最新所需的工作。

要使用该工具，请在项目目录中运行 quarkus update 命令，按照交互式提示更新您的应用程序。

如需更多信息，请参阅 将应用程序迁移到红帽构建的 Quarkus 版本 3.2 指南。

在这个版本中，Hibernate Object-Relational Mapping (ORM)扩展已更改为将 automatic IN 子句参数 padding 作为默认设置。这提高了对包含 IN 子句的查询的缓存效率。

要恢复到之前的功能并取消激活此功能，您可以将 quarkus.hibernate-orm.query.in-clause-parameter-padding 的属性值设置为 false。

红帽构建的 Quarkus 现在包含并支持 Hibernate ORM 版本 6.2，因此显著升级主要持久性层。

与版本 5.6 相比，Hibernate ORM 6.2 带来了很多改进和新功能，但也会出现一些破坏的变化。

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

在红帽构建的 Quarkus 3.2 中，Hibernate Search 已升级到版本 6.2。

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

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

要了解更多有关 Hibernate Search 中的新内容的信息，请参阅 Hibernate Search 发行注记。

Oracle JDBC 驱动程序已升级至版本 23.2。使用 Oracle DB 的客户应该注意 Oracle JDBC 驱动程序的旧版本不一定与最新的 Oracle DB 版本兼容。

被动数据源现在可以修改 CredentialsProvider 值，从而增强安全性和可配置性。这允许进行实时凭证更新，确保数据访问安全性，同时维护应用程序的可用性并最小化操作中断。

除了改进的性能外，版本 23 提高了调试信息的生成、对 Java Flight Recorder (JFR)事件的扩展支持，以及 JFR 事件流的实验性支持。它还引入了对 Java 管理扩展(JMX)的实验性支持。

环境变量现在必须通过新的 native-image 选项 - E<env-var-key>[=<env-var-value& gt;] 传递给 Mandrel。

红帽构建的 Quarkus 原生构建器现在默认为以 x86-64-v3、 AMD64 架构上的特定于处理器的应用程序二进制接口(psABI)为目标，并引进了对新的 -march 选项的支持，用于编译旧架构更兼容的原生镜像。

如需更多信息，请参阅 Red Hat build of Quarkus 社区"Native reference"指南中的有关 缺少 CPU 功能的情况。

Red Hat build of Quarkus 引入了 OpenTelemetry SDK 自动配置，简化了分布式追踪和可观察性的集成。它根据红帽构建的 Quarkus 扩展自动化 OpenTelemetry SDK 设置，消除了手动配置和优化 trace 和 metric 集合。

在 Red Hat build of Quarkus 3.2 中，quarkus-test-security-jwt 和 quarkus-test-security-oidc 测试依赖项已被改进，以支持自定义声明类型。

在这个版本中，您可以提高使用自定义 JWT 令牌声明的应用的测试覆盖。

在 Red Hat build of Quarkus 中包含 OIDC 前端注销 支持补充了支持的 OIDC 后端通道注销，从而可以在分布式环境中的多个服务间注销用户。

在红帽构建的 Quarkus 3.2 中，提供了定制 OIDC 令牌验证过程的选项。在签名验证前，这个自定义允许预处理旧的令牌标头，通常是由 OIDC 供应商（如 Microsoft Azure）发布的。

您可以在 meta-annotation 中组合 @TestSecurity 和 @JwtSecurity ；例如：

    @Retention(RetentionPolicy.RUNTIME)
    @Target({ ElementType.METHOD })
    @TestSecurity(user = "userOidc", roles = "viewer")
    @OidcSecurity(introspectionRequired = true,
        introspection = {
            @TokenIntrospection(key = "email", value = "user@gmail.com")
        }
    )
    public @interface TestSecurityMetaAnnotation {
    }

如果多个测试方法中需要相同的安全设置，这个组合很有用。

在 OIDC 多租户设置中，您可以在 application.properties 文件中设置多个租户配置，您必须指定通过注册 TenantResolver 接口实现来解析租户标识符的方式。

红帽构建的 Quarkus 3.2 引入了基于约定的静态租户解析，其中当前 HTTP 请求 URL 的最后路径段被用作租户标识符。例如，如果请求 URL 以 /keycloak 结尾，则会选择一个租户 ID 为 keycloak 的静态租户配置。

通过使用这个选项，您可以在简单的多租户配置中减少样板代码。

如需更多信息，请参阅 Quarkus "Using OpenID Connect (OIDC)多租户指南中的 配置应用程序 部分。

红帽构建的 Quarkus @RolesAllowed 注释通过配置属性支持动态角色名称，从而增强访问控制。此注解根据 SecurityIdentity （用户角色）限制访问，提供可在不更改代码的情况下进行适应和可配置的访问控制。

Red Hat build of Quarkus 3.2 引入了 Eclipse MicroProfile 6 的集成，它增强了微服务开发与最新的规格，以提高可观察、OpenAPI 和 JWT。

Red Hat build of Quarkus 3.2 引入了 Jakarta EE 10 的集成，它为开发人员提供了对当前 API 和规格的访问。

红帽构建的 Quarkus 3.2 添加了对 Maven 版本 3.9 的支持，以便开发人员可以使用最新的 Maven 功能。Maven 版本 3.8.6 或更高版本仍被支持。

Quarkus 中的 quarkus deploy 命令有助于将应用程序部署到各种云平台、容器和无服务器环境中。它生成优化的容器镜像，并将应用适应目标平台，确保高效且可靠的部署。

要使用该工具，请运行 quarkus deploy，后跟所需的部署目标和配置选项，允许无缝应用程序部署而无需手动配置。

在红帽构建的 Quarkus 3.2 中，构建和推送容器镜像现在可以更容易。如需更多信息，请参阅使用 quarkus 命令行界面的"Building Red Hat build of Quarkus apps"指南中的 容器镜像 部分。

quarkus image build docker

quarkus image push --registry=<image registry> --registry-username=<registry username> --registry-password-stdin

Quarkus 的 SmallRye GraphQL 现在支持 Apollo Federation 2 子风险，启用联合 GraphQL 模式创建。这通过整合自独立部署的 GraphQL 服务的数据来实现统一的 GraphQL API，简化了复杂的应用程序开发。

在红帽构建的 Quarkus 的 REST 数据中使用 Panache 扩展过滤，通过向 REST 端点应用预定义的查询来简化数据检索，提高性能和代码可维护性，以便通过 REST API 有效地进行数据库交互。

在列出实体时，您可以通过 @NamedQuery 注释根据实体中定义的命名查询过滤。

@Entity
@NamedQuery(name = "Person.containsInName", query = "from Person where name like CONCAT('%', CONCAT(:name, '%'))")
public class Person extends PanacheEntity {
  String name;
}

接下来，在使用生成的资源列出实体时，您可以设置 名为Query 的查询参数。使用所需查询的名称，如调用 http://localhost:8080/people?namedQuery=Person.containsInName&name=ter，这将检索所有具有"ter"名称的人员。

gRPC 异常处理有助于 gRPC 服务中更强大的错误管理，增强应用程序的可靠性和调试基于 gRPC 的应用程序。

此功能允许将错误消息作为跟踪器传递。当出现问题而不是通用"服务器异常"时，gRPC 客户端将从服务器收到特定的错误消息。

gRPC 扩展到 Vert.x 的实施增强了与 Vert.x 生态系统的协调，为使用 gRPC 通信开发微服务提供了有效的方法。

这个实现允许单个 HTTP 服务器配置，从 Red Hat build of Quarkus 安全配置中删除重复性。

在以前的版本中，您只能在 application.properties 文件中配置 Reactive REST 客户端来创建 Reactive REST 客户端。如果要创建动态客户端，此方法可能有问题。

使用红帽构建的 Quarkus 3.2，您现在可以使用新的 Quarkus 特定 API QuarkusRestClientBuilder 以编程方式创建 Reactive REST 客户端。

QuarkusRestClientBuilder 接口使用额外的配置选项创建 Reactive REST 客户端。

如需更多信息，请参阅 Quarkus "Using the REST Client" 指南中的 Programmatic client creation with QuarkusRestClientBuilder 部分。

在红帽构建的 Quarkus 3.2 中，RESTEasy Reactive 客户端被改进，以在流传输响应时提供更大的灵活性。

在这个版本中，您可以自定义 HTTP 标头、HTTP 响应和状态代码。

如需更多信息，请参阅 Quarkus "Writing REST services with RESTEasy Reactive" 指南中的 自定义标头和状态 部分。

Red Hat build of Quarkus 3.2 引入了对 REST Client Reactive 的 @Encoded 注解的支持。在这个版本中，@Encoded 注释会影响参数解码，如 PATH 和 QUERY 参数。

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

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

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

Kubernetes 客户端已从 5.12 升级到 6.7.2。如需更多信息，请参阅 Kubernetes 客户端 - 从 5.x 迁移到 6.x 指南。

Red Hat build of Quarkus 3.2 引入了 Kubernetes 扩展如何生成基于 TLS 的容器端口的更改。

早期版本会自动将名为 https 的容器端口添加到生成的部署资源。这个方法可能会造成问题，特别是在没有配置 SSL/TLS 时，导致端口无法正常工作。

在 3.2 及更高版本中，Kubernetes 扩展默认不添加名为 https 的容器端口。只有在执行以下步骤时，才会添加容器端口：

在这个版本中，一些之前已弃用的 Kubernetes 和 OpenShift 相关的属性已被删除。使用新的对应项替换它们。

另外，在这个版本中，没有 quarkus. 前缀的属性将被忽略。例如，在这个版本之前，如果您添加了 kubernetes.name 属性，它被映射到 quarkus.kubernetes.name。为了避免异常，如从 2.16.0.Final 升级到 2.16.1 时java.lang.ClassCastException。Final #30850 将不再进行。

当您继续在 Quarkus 上下文中使用 Kubernetes 和 OpenShift 时，请使用新属性，并在需要时包含 quarkus. 前缀。

在这个版本中，Jandex 成为 SmallRye 项目的一部分，将所有 Jandex 项目整合到单个存储库中： https://github.com/smallrye/jandex/。因此，Jandex Maven 插件的新版本随 Jandex 内核一起提供。

此发行版本还会更改 Maven 协调。将旧的协调替换为新协调。

如果使用 Maven Enforcer 插件，请将其配置为对 org.jboss:jandex 的任何依赖项。Gradle 用户提供了一个等同的插件。

Jandex 3 包含很多有趣的功能和改进。不幸的是，这些更改需要一些破坏的更改。以下是推荐的迁移路径：

在此发行版本中，Jandex 引入了一个新的文档站点。尽管它是正在进行的工作，但随着时间的推移将变得更加全面。如需更多信息，您还可以参考改进的 Jandex Javadoc。

在这个版本中，之前弃用的 io.quarkus.arc.config.ConfigProperties 注解已被删除。

反之，使用 io.smallrye.config.ConfigMapping 注解来注入多个相关的配置属性。

如需更多信息，请参阅 "Mapping configuration to objects" 指南中的 @ConfigMapping 部分。

在这个版本中，不支持在私有方法上声明拦截器绑定注解，并触发构建失败；例如：

jakarta.enterprise.inject.spi.DeploymentException: @Transactional does not affect method com.acme.MyBean.myMethod() because the method is private. [...]

在早期版本中，声明私有方法上的拦截器绑定注解仅在日志中触发警告，但会被忽略。

这个支持更改旨在防止在私有方法中意外使用拦截器注解，因为它们没有影响，并可能导致混淆。

要解决这一更改，请从私有方法中删除此类注释。如果删除这些注解不可行，您可以将配置属性 quarkus.arc.fail-on-intercepted-private-method 设置为 false。此设置将系统恢复到之前的行为，其中只记录警告。

此发行版本删除了之前已弃用的 @AlternativePriority 注释。将它替换为 @Alternative 和 @Priority 注释。

@AlternativePriority(1)

@Alternative
@Priority(1)

使用带有 @ Priority 注解的 jakarta.annotation.Priority 而不是 io.quarkus.arc.Priority，该注解已弃用，并计划在以后的发行版本中删除。两个注解都执行相同的功能。

此发行版本更新了 Mockito 版本 5.x。值得注意的是，Mockito 将默认的模拟制造商切换为 50.0 发行版中 的 内联。

但是，要保留自 Quarkus 1.x 起熟悉了模拟行为 Quarkus 用户，并防止出现大量 测试套件的内存泄漏，Quarkus 3.0 将 mockmaker 修复到 子类，而不是 内联，直到后者被完全支持。

如果要强制使用 内联 模拟制造商，请按照以下步骤执行：

Quarkus 已嵌套其 Maven 插件，以支持 Maven 3.9。因此，Quarkus 支持的最小 Maven 版本从 3.6.2 提升到 3.8.6 或更高版本。确保您的开发环境已相应地更新，以从最新的改进和功能中受益。

在这个版本中，之前弃用的 io.quarkus:quarkus-bootstrap-maven-plugin Maven 插件已被删除。

此插件仅用于 Quarkus 扩展开发。因此，如果您要开发自定义 Quarkus 扩展，您必须将工件 ID 从 io.quarkus:quarkus-bootstrap-maven-plugin 改为 io.quarkus-extension-maven-plugin。

Mutiny 是一个被动编程库，其版本 1.x 基于 org.reactivestream 接口，而版本 2 基于 java.util.concurrent.Flow。这些 API 相同，但软件包名称已更改。

Mutiny 提供在 Mutiny 2 (Flow API)和其他带有传统重新主动流 API 的其他库之间桥接的适配器。

在这个 3.2 发行版本中，以下来自使用 Panache 和 Hibernate ORM 的 Hibernate ORM 方法已被删除：

反之，使用 Panache.getEntityManager (Class<?> clazz) 方法。

在这个版本中，Hibernate Object-Relational Mapping (ORM)扩展已更改为将 automatic IN 子句参数 padding 作为默认设置。这提高了对包含 IN 子句的查询的缓存效率。

要恢复到之前的功能并取消激活此功能，您可以将 quarkus.hibernate-orm.query.in-clause-parameter-padding 的属性值设置为 false。

在这个版本中，Quarkus 依赖于 Hibernate Reactive 2 扩展而不是 Hibernate Reactive 1。这个变化意味着行为和数据库模式期望有一些变化，它们与早期版本不兼容。

大多数更改都与 Hibernate Reactive 2 相关，具体取决于 Hibernate ORM 6.2 而不是 Hibernate ORM 5.6。

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

假设您的 Hibernate Search 映射包含 GeoPoint 字段，该字段使用 projectable 选项的默认值，以及 排序选项的默认值或 Sortable.NO。在这种情况下，因为这些字段中缺少 doc 值，Elasticsearch 模式在启动时验证会失败。

要防止这个失败，请完成以下步骤之一：

如需更多信息，请参阅 "Hibernate Search 6.2.1.Final: Migration Guide from 6.1" 中的数据格式和模式更改 部分。

另外，quarkus.hibernate-search-orm.automatic-indexing.enable-dirty-check 属性已被弃用，计划在以后的版本中删除。没有可替换它的替代选择。删除后，计划 Search 会在事务修改对象字段后始终触发重新索引。也就是说，如果事务使字段"dirty"。

如需更多信息，请参阅"Hibernate Search 6.2.1.Final: Migration Guide from 6.1"中的 配置更改 部分。

在这个版本中，Quarkus 不支持手动创建 ValidatorFactory 实例。反之，您必须使用 Validation.buildDefaultValidatorFactory （） 方法，它返回由 Quarkus 管理的 ValidatorFactory 实例，您通过上下文和依赖注入(CDI)注入。此更改的主要原因是，必须仔细设计 ValidatorFactory 才能在原生可执行文件中工作。在此发行版本中，您仍然可以手动创建 ValidatorFactory 实例，并在可能正常工作的情况下自行处理它。此更改旨在提高与组件的兼容性，创建自己的 ValidatorFactory。

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

如果您使用 Java 数据库连接(JDBC)将 Quartz 扩展 的作业存储在数据库中，请运行以下查询来更新 JOB_DETAILS 表中的作业类名称：

UPDATE JOB_DETAILS SET JOB_CLASS_NAME = 'io.quarkus.quartz.runtime.QuartzSchedulerImpl$InvokerJob' WHERE JOB_CLASS_NAME = 'io.quarkus.quartz.runtime.QuartzScheduler$InvokerJob';

QuarkusTransaction.run 和 QuarkusTransaction.call 方法已弃用，现在使用新的、更明确的方法。

更新依赖于这些已弃用方法的代码，如下所示：

QuarkusTransaction.run(() -> { ... });
QuarkusTransaction.call(() -> { ... });

QuarkusTransaction.requiringNew().run(() -> { ... });
QuarkusTransaction.requiringNew().call(() -> { ... });

QuarkusTransaction.run(QuarkusTransaction.runOptions()
        .semantic(RunOptions.Semantic.REQUIRED),
        () -> { ... });
QuarkusTransaction.call(QuarkusTransaction.runOptions()
        .semantic(RunOptions.Semantic.REQUIRED),
        () -> { ... });

QuarkusTransaction.joiningExisting().run(() -> { ... });
QuarkusTransaction.joiningExisting().call(() -> { ... });

QuarkusTransaction.run(QuarkusTransaction.runOptions()
        .timeout(10)
        .exceptionHandler((throwable) -> {
            if (throwable instanceof SomeException) {
               return RunOptions.ExceptionResult.COMMIT;
            }
            return RunOptions.ExceptionResult.ROLLBACK;
        }),
        () -> { ... });
QuarkusTransaction.call(QuarkusTransaction.runOptions()
        .timeout(10)
        .exceptionHandler((throwable) -> {
            if (throwable instanceof SomeException) {
               return RunOptions.ExceptionResult.COMMIT;
            }
            return RunOptions.ExceptionResult.ROLLBACK;
        }),
        () -> { ... });

QuarkusTransaction.requiringNew()
        .timeout(10)
        .exceptionHandler((throwable) -> {
            if (throwable instanceof SomeException) {
               return RunOptions.ExceptionResult.COMMIT;
            }
            return RunOptions.ExceptionResult.ROLLBACK;
        })
        .run(() -> { ... });
QuarkusTransaction.requiringNew()
        .timeout(10)
        .exceptionHandler((throwable) -> {
            if (throwable instanceof SomeException) {
               return RunOptions.ExceptionResult.COMMIT;
            }
            return RunOptions.ExceptionResult.ROLLBACK;
        })
        .call(() -> { ... });

如需更多信息，请参阅 "Using transaction in Quarkus" 指南中的 Programmatic method 部分。

在这个版本中，quarkus.transaction-manager.object-store-directory 配置属性被重命名为 quarkus.transaction-manager.object-store.directory。通过将旧属性名称替换为新属性来更新您的配置。

此发行版本删除了之前为 smallrye-reactive-messaging-kafka 扩展已弃用的 vertx-kafka-client 依赖项。虽然它不用于客户端实现，vertx-kafka-client 为 io.vertx.kafka.buffer.Buffer 软件包提供了默认的 Kafka Serialization 和 Deserialization (SerDes),io.vertx.core.json.JsonObject, 和 io.vertx.core.json.JsonArray 类型来自 io.vertx.kafka.client.serialization 软件包。

如果您需要这个依赖项，您可以获取 io.quarkus.kafka.client.serialization 软件包中上述类型的 SerDe。

在这个版本中，GraalVM/Mandrel 中的更改会影响对 .so 文件（如 Java Abstract Window Toolkit (AWT)扩展）的扩展。

在使用这些扩展时，您必须将对应的 .so 文件复制到原生容器中，例如：

COPY --chown=1001:root target/*.so /work/
COPY --chown=1001:root target/*-runner /work/application

在这个 3.2 发行版本中，如果您在最新的机器上构建原生可执行文件并在较旧的机器上运行它们，您可能会在启动应用程序时遇到以下故障：

The current machine does not support all of the following CPU features that are required by the image: [CX8, CMOV, FXSR, MMX, SSE, SSE2, SSE3, SSSE3, SSE4_1, SSE4_2, POPCNT, LZCNT, AVX, AVX2, BMI1, BMI2, FMA].
Please rebuild the executable with an appropriate setting of the -march option.

此错误消息表示，原生编译使用了运行应用的 CPU 不支持的更多高级指令集。要临时解决这个问题，请在 application.properties 文件中添加以下行：

quarkus.native.additional-build-args=-march=compatibility

然后，重建您的原生可执行文件。此设置强制原生编译使用旧的指令集，从而增加兼容性几率，但会降低优化。

要显式定义目标架构，请运行 native-image -march=list 来获取受支持的配置列表。然后，指定一个目标架构 ; 例如：

quarkus.native.additional-build-args=-march=x86-64-v4

如果您在旧的 AMD64 主机时遇到问题，请在使用 -march=x86-64-v2 前尝试 -march= x86-64-v2。

原生 镜像构建选项的 GraalVM 文档指出 "[the -march 参数生成] 指令用于特定机器类型。[This parameter] 默认为 AMD64 上的 x86-64-v3 和 AArch64 上的 armv8-a。使用 -march=compatibility 实现最佳兼容性，如果在同一台机器上或具有相同 CPU 功能的机器上部署原生可执行文件，则使用 -march=native 以获得最佳性能。要列出所有可用机器类型，请使用 -march=list "。

在这个版本中，之前弃用的 @io.quarkus.test.junit.NativeImageTest 和 @io.quarkus.test.junit.DisabledOnNativeImageTest 注解是 rimage::images/ref_changes- that-affect-backward-compatibility-88d2f.png[].使用新的对应项替换它们。

替换注解的功能等同于删除的注解。

在这个版本中，对 OpenTracing 驱动程序的支持已弃用。计划在以后的 Quarkus 版本中删除 OpenTracing 驱动程序。

在这个版本中，SmallRye GraphQL 扩展已替换为 OpenTelemetry 的 OpenTracing 集成。因此，在使用 OpenTracing 时，扩展不再为 GraphQL 操作生成 span。

另外，在这个版本中，quarkus.smallrye-graphql.tracing.enabled 配置属性已过时，并已被删除。相反，SmallRye GraphQL 扩展会在存在 OpenTelemetry 扩展时自动生成 span。

更新 Quarkus 应用程序以使用 OpenTelemetry，以便它们保持与将来的 Quarkus 版本兼容。

在这个 3.2 发行版本中，Micrometer 扩展默认以 application/openmetrics-text 格式导出指标，与 Prometheus 标准一致。此更改有助于使您的数据更易于阅读和解释。

要以较早格式获取指标，您可以将 Accept 请求标头改为 text/plain。例如，使用 'curl 命令：

curl -H "Accept: text/plain" localhost:8080/q/metrics/

在这个版本中，OpenTelemetry (OTel)扩展有显著改进。在此发行版本中，OpenTelemetry SDK (OTel SDK)是在构建时创建的，且有有限的配置选项；最重要的是，它在运行时无法禁用。现在，它提供了更高的灵活性。它在运行时可以通过设置 quarkus.otel.sdk.disabled=true 来禁用。

构建时的一些准备步骤后，OTel SDK 会使用 OTel 自动配置功能在运行时进行配置。此功能支持 Java OpenTelemetry SDK 中定义的一些属性。如需更多信息，请参阅 OpenTelemetry SDK 自动配置 参考。

OpenTelemetry 扩展与早期版本兼容。大多数属性已被弃用，但仍然与新属性一起工作，直到它们在以后的发行版本中被删除为止。您可以将已弃用的属性替换为新属性。

在这个 3.2 发行版本中，删除了一些旧的 quarkus.opentelemetry.tracer.sampler- 相关的属性值。

如果 sampler 是基于父的，则不需要设置 now-dropped quarkus.opentelemetry.tracer.sampler.parent-based 属性。

将以下 quarkus.opentelemetry.tracer.sampler 值替换为新值：

现在，提供了很多新属性。如需更多信息，请参阅使用 OpenTelemetry 的 Quarkus 指南。

Quarkus 允许许多类的上下文和依赖注入(CDI)配置： IdGenerator、Resource 属性、Sampler 和 SpanProcessor。这是标准 OTel 中不可用的功能，但出于方便起见，仍然在此提供。但是，通过 LateBoundBatch SpanProcessor 创建 SpanProcessor 的 CDI 现已弃用。如果需要覆盖或自定义它，则非常感谢反馈。处理器将继续用于支持早期版本，但很快将使用与 OTel SDK 捆绑的标准导出。这意味着默认导出器使用以下配置：

quarkus.otel.traces.exporter=cdi

作为技术预览，现在通过设置来提供 stock OTLP exporter：

quarkus.otel.traces.exporter=otlp

现在，可以使用 OTel SDK 的额外配置，将标准服务提供商接口(SPI) hook 用于 Sampler 和 SpanExporter。剩余的 SPI 也可以访问，但仍然需要通过测试进行兼容性验证。如需更多信息，请参阅更新的 OpenTelemetry 指南。

quarkus.datasource.jdbc.url=jdbc:otel:postgresql://localhost:5432/mydatabase
# use the 'OpenTelemetryDriver' instead of the one for your database
quarkus.datasource.jdbc.driver=io.opentelemetry.instrumentation.jdbc.OpenTelemetryDriver

在这个 3.2 发行版本中，您可以使用更简单的配置：

quarkus.datasource.jdbc.telemetry=true

使用这个配置，您不需要更改数据库 URL 或声明不同的驱动程序。

跨原始资源共享(CORS)过滤器的默认行为已进行了显著更改。在早期版本中，当启用 CORS 过滤器时，它默认支持所有原始卷。在这个 3.2 发行版本中，不再支持所有原始卷。现在，如果要允许所有原始卷，您必须明确将其配置为这样做。

在进行全面的评估后，如果您确定所有源都需要支持，请使用以下方法之一配置系统：

quarkus.http.cors=true
quarkus.http.cors.origins=/.*/

相同的原始请求会获得支持，而无需 quarkus.http.cors.origins 配置。因此，只有在允许信任的第三方源请求时，调整 quarkus.http.cors.origins 才会变得至关重要。在这种情况下，启用所有原始卷可能会造成不必要的风险。

在这个 3.2 发行版本中，OpenAPI 更改了其跨原始资源共享(CORS)设置，不再默认启用通配符(*)原始支持。这个更改有助于防止 OpenAPI 文档的潜在泄漏，提高应用程序的整体安全性。

虽然您可以在 dev 模式中启用通配符源支持，但务必要考虑潜在的安全影响。避免在生产环境中启用所有源，因为它会将您的应用程序暴露给安全威胁。确保您的 CORS 设置与您的生产环境的建议安全最佳实践一致。

在这个 3.2 发行版本中，在 OIDC 授权代码流完成后创建的 OpenID Connect (OIDC)会话 cookie 被默认加密。在大多数情况下，您不太可能注意到这个变化。

但是，如果 mTLS 或 private_key_jwt 验证方法 - OIDC 客户端私钥为 JSON Web Token (JWT)签名 - 在 Quarkus 和 OIDC 供应商之间使用，则会生成一个内存加密密钥。这个密钥生成可能会导致一些 pod 无法解密会话 Cookie，特别是在处理多个请求的应用程序中。当尝试解密 Cookie 的 pod 不是加密它的 pod 时，可能会出现这种情况。

如果出现问题，请注册 32 个字符的加密 secret；例如：

quarkus.oidc.token-state-manager.encryption-secret=eUk1p7UB3nFiXZGUXi0uph1Y9p34YhBU

加密会话 Cookie 不能超过 4096 字节，这可能会导致一些浏览器忽略它。如果出现这种情况，请尝试一个或多个以下步骤：

如果应用程序用户从可信网络访问 Quarkus 应用程序，请通过应用以下配置来禁用会话 Cookie 加密：

quarkus.oidc.token-state-manager.encryption-required=false

在这个版本中，对于 Quarkus OpenID Connect (OIDC)扩展，会话 Cookie SameSite 属性默认设置为 Lax。

在一些较早版本的 Quarkus 中，OIDC 会话 Cookie SameSite 属性默认设置为 Strict。此设置引入了不同浏览器处理会话 Cookie 的不可预测性。

在这个 3.2 发行版本中，默认验证 OpenID Connect (OIDC) ID 令牌 aud (audience)声明。这个声明必须与 OIDC 规格的要求相等配置的 quarkus.oidc.client-id 属性的值。

要覆盖预期的 ID 令牌 audience 值，请设置 quarkus.oidc.token.audience 配置属性。如果您处理没有设置 ID 令牌声明的不合规 OIDC 供应商，您可以将 quarkus.oidc.token.audience 设置为 任何。

在此版本之前，Quarkus 使用 password 作为 JSON Web Token (JWT)密钥和密钥存储的默认密码。在这个版本中，这个默认值已被删除。

如果您仍然使用默认密码，请设置一个新值来替换 application.properties 文件中的以下属性 的密码 ：

quarkus.oidc-client.credentials.jwt.key-store-password=password
quarkus.oidc-client.credentials.jwt.key-password=password

在这个版本中，以下更改会影响 RESTEasy Reactive 中的多部分支持：

JAXB 扩展检测使用 JAXB 注释的类，并将它们注册到默认的 JAXBContext 实例中。在此版本之前，类和 JAXB 之间的任何问题或冲突都会在运行时触发 JAXB 异常，并提供了有助于对问题进行故障排除的详细描述。但是，您可以在构建阶段预先处理这些冲突。

此发行版本添加了一个功能，可在构建时验证 JAXBContext 实例，以便您可以在开发周期早期检测和修复 JAXB 错误。

例如，如以下代码块中所示，将这两个类绑定到默认的 JAXBContext 实例会导致 JAXB 异常。这是因为类共享相同的名称 Model，尽管在不同的软件包中都存在。这个并发命名会创建一个冲突，从而导致异常。

package org.acme.one;

import jakarta.xml.bind.annotation.XmlRootElement;

@XmlRootElement
public class Model {
    private String name1;

    public String getName1() {
        return name1;
    }

    public void setName1(String name1) {
        this.name1 = name1;
    }
}

package org.acme.two;

import jakarta.xml.bind.annotation.XmlRootElement;

@XmlRootElement
public class Model {
    private String name2;

    public String getName2() {
        return name2;
    }

    public void setName2(String name2) {
        this.name2 = name2;
    }
}

要激活这个功能，请添加以下属性：

quarkus.jaxb.validate-jaxb-context=true

另外，这个版本添加了 quarkus.jaxb.exclude-classes 属性。使用此属性，您可以指定从绑定到 JAXBContext 的类。您可以提供完全限定类名称或软件包列表的逗号分隔列表。

例如，要解决上例中的冲突，您可以排除一个或多个类：

quarkus.jaxb.exclude-classes=org.acme.one.Model,org.acme.two.Model

或者，您可以排除软件包下的所有类：

quarkus.jaxb.exclude-classes=org.acme.*