如何正确通过 JVM 参数指定 Spring Boot 应用的启动端口

雨涛吖_6892

雨涛吖_6892

2026-09-06

454人浏览

原创

如何正确通过 JVM 参数指定 Spring Boot 应用的启动端口

在 Windows 下使用 java -Dserver.port=xxx -jar app.jar 启动 Spring Boot 应用时出现“Could not find or load main class”或“Unable to access jarfile”错误,根本原因在于 PowerShell 对命令行参数的解析方式与 CMD 不同,导致 -D 参数被错误拆分或识别。

在 windows 下使用 `java -dserver.port=xxx -jar app.jar` 启动 spring boot 应用时出现“could not find or load main class”或“unable to access jarfile”错误,根本原因在于 powershell 对命令行参数的解析方式与 cmd 不同,导致 `-d` 参数被错误拆分或识别。

Spring Boot 应用支持多种方式自定义 server.port,但命令行启动时的 JVM 参数顺序和 Shell 环境兼容性至关重要。上述报错并非 Spring Boot 本身的问题,而是 PowerShell 的参数解析机制所致:

  • PowerShell 将 -Dserver.port=8082 中的 . 视为属性访问操作符,尝试将其解析为 PowerShell 表达式(如 $obj.port),从而破坏了 JVM 参数格式;
  • 当执行 java -Dserver.port=8082 -jar xxx.jar 时,PowerShell 可能将 -Dserver.port=8082 错误地截断或转义,使 java 进程实际接收到类似 -Dserverport=8082 两个独立参数,最终触发 ClassNotFoundException: /port=8082(因路径解析异常);
  • java -jar -Dserver.port=8082 xxx.jar 失败,则是因为 -jar 必须是 java 命令的最后一个选项,其后必须紧跟 JAR 文件路径;PowerShell 在重排参数时进一步加剧了语法错误。

✅ 正确解决方案如下:

方案 1:切换至 CMD(推荐快速验证)
在 IntelliJ IDEA 终端中点击右上角齿轮图标 → "Shell path" → 改为 cmd.exe,然后运行:

<code class="bash">java -Dserver.port=8082 -jar .\target\demoApp-0.0.1-SNAPSHOT.jar</code>

方案 2:在 PowerShell 中安全执行(需转义)
使用单引号包裹 JVM 参数,防止 PowerShell 解析点号:

<code class="powershell">java '-Dserver.port=8082' -jar .\target\demoApp-0.0.1-SNAPSHOT.jar</code>

✅ 注意:单引号 ' 是关键,双引号 " 在 PowerShell 中仍可能触发变量展开。

Spring Boot 3.3.13
Spring Boot 3.3.13

Spring Boot下载页提供 3.3.13 官方源码 ZIP,并整理快速入门、项目创建、配置和自动配置说明。

下载

方案 3:使用 Spring Boot 官方支持的等效方式(更健壮)
避免依赖 JVM 系统属性,改用 Spring Boot 的外部化配置:

<code class="bash">java -jar .\target\demoApp-0.0.1-SNAPSHOT.jar --server.port=8082</code>

该写法使用 -- 前缀,属于 Spring Boot 的 命令行参数(而非 JVM 参数),完全兼容 CMD、PowerShell、Bash,且优先级高于 application.properties

? 额外提示:

  • 永远确保 -jarjava 命令中最后指定的选项,其后只能跟 JAR 路径;
  • 若项目使用 Maven,也可在打包时注入属性:mvn spring-boot:run -Dspring-boot.run.jvmArguments="-Dserver.port=8082"
  • 生产环境建议通过 application.yml 或环境变量(SERVER_PORT=8082)配置,提升可维护性与安全性。

综上,问题本质是 Shell 环境与 JVM 参数语法的交互陷阱。掌握 --server.port 这一 Spring Boot 原生参数,可一劳永逸规避跨平台终端兼容性问题。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

8777

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

5982

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

5372

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

964

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

808

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1156

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2329

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19671

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1055

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Spring Boot 官方快速入门指南
Spring Boot 官方快速入门指南

共0课时 | 0人学习

Spring Boot 官方参考文档
Spring Boot 官方参考文档

共0课时 | 0人学习

尚硅谷新版SpringBoot3教程
尚硅谷新版SpringBoot3教程

共0课时 | 0人学习