Quarkus 3.40 LTS 全平台已在 2026-09-30 落地,社区最新微版本是 3.40.1。对仍停在 3.x 的生产线来说,这是新的 LTS 落点,也是排程里 3.x 侧的末段班车:按 Release Planning,4.0 正式全平台公告定在 2026-11-25(提案)。应用侧请钉 io.quarkus.platform:quarkus-bom:3.40.1,用官方 quarkus update / Maven plugin update 做升级,再对照空壳状态的 Migration Guide 3.40 与本机回归。

说明:本稿按 releases 页、GitHub tag 与 Maven Central 核对。写稿时 quarkus.io/blog 尚无 3.40 发布博文,下文不虚构博文日期。命令与升级流程未本地完整验证。

版本事实(已核对)

项值来源
发行线3.40 LTS,Community Maintenance = Activereleases
发布日2026-09-30同上
最新社区微版本3.40.1(同日)同上;GitHub 3.40.1
平台 BOM(用户消费)io.quarkus.platform:quarkus-bom:3.40.1Maven Central POM HTTP 200;code.quarkus.io API 当前 stream 3.40 → 3.40.1
平台 BOM 3.40.0不存在(HTTP 404)repo1.maven.org
Core io.quarkus:quarkus-bom3.40.0 与 3.40.1 均有Maven Central
版本文档quarkus.io/version/3.40/guides/已可访问
官方发布博文写稿时无blog 检索与常见 URL 404
Migration Guide 3.40Wiki 已建,正文目前仅推荐 quarkus update,未列出具体破坏性条目Migration-Guide-3.40

LTS 节奏(releases 页原文):minor 约每 4–6 周;LTS 约每 6 个月,社区侧关键缺陷与安全补丁维护约 12 个月。非 LTS 维护到下一 minor。表里 3.40 的 Community Maintenance 目前只标 Active,未写出具体 EOL 日期,本文不臆造。

排程侧(Release Planning,页面编辑标注 Sep 15, 2026):

  • 3.40 LTS:Core Final 2026-09-23,Full Platform(正式公告)2026-09-30
  • 3.39:Feature freeze for 3.40 LTS;Full Platform 2026-08-26
  • 4.0(提案):Full Platform 正式公告 2026-11-25;同日规划里还有 4.0 Beta1 Full Platform(2026-09-30)
  • 当前 Current version:3.40;LTS 列表含 3.40 / 3.33 / 3.27 / 3.20;Next in 3.x:3.41

同页还有一句值得记:平台用户消费的是 Platform 发布(io.quarkus.platform:quarkus-bom),Core 先出、Platform 通常晚约一周。这次平台坐标直接落在 3.40.1,应用请跟平台 BOM,不要去找不存在的 platform:quarkus-bom:3.40.0。

相对 3.39:生产选型怎么摆

3.39 在 releases 表里:Released 2026-08-26,Community Maintenance Ended 2026-09-30,最新微版本 3.39.5(2026-09-23)。也就是说,3.40 全平台当天,3.39 的社区维护窗口已经关掉。

3.33 LTS 仍标 Until 2027-03-25,最新微版本写稿时可见 3.33.4(2026-09-30)。releases 页顶部横幅仍写「Recommended for production: use the latest LTS release, Quarkus 3.33」(抓取时原文如此)。新 LTS 刚出当天,横幅与表格并存时,以表格里的 Active LTS 与你们自己的回归节奏为准,不要只盯横幅一句。

实务上可以这样排:

  1. 新开服务 / 愿意跟新 LTS:目标钉 3.40.1(平台 BOM),把 3.39 当过渡源,尽快迁走。
  2. 已在 3.33 LTS 且稳定:可继续吃 3.33 的维护窗口到 2027-03-25,另开分支评估 3.40;不必在发布日当天强切。
  3. 还在 3.39:社区维护已结束,优先升到 3.40.1,别继续堆 3.39 patch。
  4. 盯 4.0:排程提案里正式全平台在 2026-11-25。4.0 前把生产线落到 3.40 LTS,升级跨度会更可控。社区 FAQ / Insights 转录里多次把 3.40 说成 3.x 末段 LTS,但正式破坏性清单仍以日后 Migration Guide / 发布说明为准。

效率工具视角只关心:版本钉死、CLI/插件可复现、升级命令可回滚。不在这里展开架构或运维拓扑。

3.40.0 与 3.40.1:GitHub 变更摘要

应用请用平台 3.40.1。Core 两个 tag 的 changelog(GitHub Release 正文)如下,便于区分「同日微版本」修了什么。

3.40.0(Published 2026-09-30T11:20:52Z)条目很少,与 LTS 在 3.39 已 feature freeze 的排程一致:

  • #56750:增强 CycloneDX 文档与配置说明,强调 JSON 格式优先级
  • #56829:更新 Scalpel 0.4.2

3.40.1(Published 2026-09-30T11:20:54Z)以修复为主,和工具链/运行时更相关的包括:

  • Redis:CacheResult 高并发下返回 QUEUED(#48420);阻塞事务 API 错误处理(#56976)
  • Java 25 native:补 RdsUtilities(#56834)
  • RestEasy Reactive:void 返回类型相关告警与索引检查(#56942 / #56944)
  • WebSockets Next:decode 失败且背压时 Multi 流卡住(#56946)
  • 代理 DNS:DnsClient 泄漏(#56958 / #56961)
  • AeshLauncher 信号协议与超时诊断加固(#56938)
  • MariaDB GraalVM metadata 与 AWS SDK classpath 场景(#56943)

这些是发行说明里的修复项,不构成「你必须改代码」的清单。是否命中取决于你是否启用对应扩展。

破坏性变更:写稿时 Migration Guide 3.40 没有逐条 breaking 列表,只有「优先用 quarkus update」的说明。若日后 wiki 或博文补条目,以官方为准,本稿不编造。

BOM / CLI:怎么升到 3.40.1

版本文档 Update projects to the latest Quarkus version(experimental)给出的路径如下。先建分支,再执行。

Quarkus CLI

quarkus update
# 指定 stream 示例(官方文档写法)
quarkus update --stream=3.40

Maven(官方文档中的插件坐标已带 3.40.1)

./mvnw io.quarkus.platform:quarkus-maven-plugin:3.40.1:update -N
# 指定 stream 示例
./mvnw io.quarkus.platform:quarkus-maven-plugin:3.40.1:update -N -Dstream=3.40

手工钉平台版本时,常见属性形态是(与 code.quarkus / 平台 BOM 一致):

<properties>
  <quarkus.platform.group-id>io.quarkus.platform</quarkus.platform.group-id>
  <quarkus.platform.artifact-id>quarkus-bom</quarkus.platform.artifact-id>
  <quarkus.platform.version>3.40.1</quarkus.platform.version>
</properties>
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>${quarkus.platform.group-id}</groupId>
      <artifactId>${quarkus.platform.artifact-id}</artifactId>
      <version>${quarkus.platform.version}</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

官方 update 指南还写明:OpenRewrite 配方只覆盖迁移的一部分,务必再读目标版本 Migration Guides,用 diff 审变更,构建、测试、行为确认后再上生产。指南前提条件含 JDK 17+、Apache Maven 3.9.16、项目基于 Quarkus 2.13+。Getting Started(3.40)同样要求 JDK 17+。

CLI 安装可按 Building Quarkus apps with Quarkus CLI 用 JBang / SDKMAN! 等渠道;发行资产里也有 quarkus-cli-3.40.1.zip / .tar.gz(见 GitHub 3.40.1 Assets)。装完后用 quarkus -v 核对。

建议的最小回归清单(工具链侧,非官方强制):

  1. ./mvnw -Dquarkus.platform.version=3.40.1 clean verify(或 update 后的等价命令)
  2. Dev mode 冒烟:REST、你们在用的 Dev Services
  3. 若做 native:Mandrel/GraalVM 按 3.40 文档重跑;用到 Redis / 代理 / WebSockets Next / Java 25 native 的,对照上面 3.40.1 修复项做定向测
  4. 对比升级前后 dependency:tree 与关键扩展版本

文档与后续补链

参考

— 感谢阅读 —

一起交流

分享你的思考,让讨论更进一步。