1.15. 调试 Quarkus 项目


当红帽构建的 Quarkus 以开发模式启动时,会默认启用调试,调试器会监听端口 5005,而不挂起 JVM。您可以从命令行或配置系统属性来启用和配置 Quarkus 的调试功能。您还可以使用 Quarkus CLI 调试项目。

先决条件

  • 您已创建了红帽构建的 Quarkus Maven 项目。
  • 已安装 Quarkus 命令行界面(CLI),这是可用于编译和调试项目的方法之一。如需更多信息 ,请参阅安装 Quarkus CLI
注意

Quarkus CLI 仅用于开发模式。红帽不支持在生产环境中使用 Quarkus CLI

流程

使用以下方法之一控制调试:

通过配置系统属性来控制调试器

  1. 更改 debug 系统属性之一,其中 PORT 是调试器侦听的端口:

    • 错误 :JVM 在禁用调试模式时启动。
    • true :JVM 以调试模式启动,并侦听端口 5005
    • 客户端 :JVM 在客户端模式中启动,并尝试连接到 localhost:5005
    • PORT: JVM 以调试模式启动并侦听 PORT
  2. 要在以 debug 模式运行时挂起 JVM,请将 suspend 系统属性的值设置为以下值之一:

    • ytrue :调试模式 JVM 启动挂起。
    • nfalse :调试模式 JVM 启动而不暂停。

从命令行控制调试器

  • 要使用暂停的 JVM 以调试模式编译和启动 Quarkus 应用程序,请使用以下方法之一

    • 使用 Maven:

      ./mvnw quarkus:dev -Dsuspend
      Copy to Clipboard Toggle word wrap
    • 使用 Quarkus CLI:

      quarkus dev -Dsuspend
      Copy to Clipboard Toggle word wrap

为特定主机网络接口启用调试器

在开发模式中,为了安全起见,Quarkus 将 debug 主机接口设置为 localhost

要为特定主机网络接口启用调试器,您可以使用以下方法之一使用 -DdebugHost 选项:

  • 使用 Maven:

    ./mvnw quarkus:dev -DdebugHost=<host-ip-address>
    Copy to Clipboard Toggle word wrap
  • 使用 Quarkus CLI:

    quarkus dev -DdebugHost=<host-ip-address>
    Copy to Clipboard Toggle word wrap

其中 < host-ip-address > 是您要启用调试的主机网络接口的 IP 地址。

注意

要在所有主机接口上启用调试,请将 < host-ip-address& gt; 替换为以下值:

0.0.0.0
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat