Quarkus默认端口工作机制及端口残留问题咨询

• 清理构建缓存
  Quarkus的编译产物缓存可能留存了旧配置，执行对应构建命令彻底清理：

  • Maven: ./mvnw clean
  • Gradle: ./gradlew clean
    清理完成后重新编译运行应用。

• 检查环境变量
  Quarkus会优先读取环境变量QUARKUS_HTTP_PORT，排查当前终端或系统的环境变量：

  • Linux/macOS终端执行：echo $QUARKUS_HTTP_PORT
  • Windows命令行执行：echo %QUARKUS_HTTP_PORT%
    如果输出为8089，清除该环境变量后重启应用。

• 排查IDE运行配置
  IDE的运行/调试配置可能硬编码了端口参数：

  • 比如IntelliJ IDEA中，打开Run Configuration，检查VM options是否存在-Dquarkus.http.port=8089，或Quarkus专属配置里的端口设置，删除后重新运行。

• 删除Quarkus本地缓存
  Quarkus的本地缓存目录可能留存了旧配置信息，删除对应目录后重试：

  • Linux/macOS: ~/.quarkus/
  • Windows: C:\Users\<你的用户名>\.quarkus\

• 检查高优先级配置文件
  确认是否存在其他高优先级配置文件覆盖了默认值：

  • 查看application-dev.properties、application-prod.properties等环境专属配置
  • 检查项目中是否有application.yml（若使用YAML格式）的端口配置
  • 排查项目根目录外的配置文件（如父目录下的application.properties），Quarkus会扫描此类路径

内容的提问来源于stack exchange，提问作者Sergio Agüero