Spring Boot应用不识别VM选项配置的服务器端口问题

我来帮你排查下这个困扰你的问题，你遇到的情况在使用IntelliJ+Spring Boot开发时挺常见的，咱们一步步拆解可能的原因和解决办法：

1. 先确认你的运行配置类型 #

你提到是通过IntelliJ的调试/运行按钮启动应用，首先要搞清楚这个配置是Application类型（直接启动主类）还是Maven类型（执行spring-boot:run命令）：

• 如果是Maven类型的配置：你在Application的Runner标签里添加的VM参数不会生效！得切换到Maven配置的设置页，在VM options里添加-Dserver.port=8001，或者直接在Command line里写spring-boot:run -Dserver.port=8001。
• 如果是Application类型的配置：你已经在Runner标签取消勾选了"use project settings"并添加了-Dserver.port=8001，且控制台显示命令里包含这个参数，那咱们继续往下排查。

2. 检查是否有更高优先级的配置覆盖了VM参数 #

Spring Boot的配置有优先级顺序，环境变量的优先级高于系统属性（也就是你通过-D设置的VM参数），而系统属性又高于application.properties。所以可以做两个验证：

• 在你的主类里添加一行代码，打印系统属性和环境变量的值：

  public static void main(String[] args) {
      System.out.println("System property server.port: " + System.getProperty("server.port"));
      System.out.println("Environment variable SERVER_PORT: " + System.getenv("SERVER_PORT"));
      SpringApplication.run(YourApplication.class, args);
  }
  

  启动后看控制台输出：
  • 如果System.getProperty("server.port")显示null：说明你的VM参数根本没被正确传递到JVM里，可能是IntelliJ的配置没保存，或者缓存问题（后面会说解决办法）。
  • 如果显示8001但还是用8080启动：那大概率是环境变量SERVER_PORT被设成了8080，它会覆盖系统属性的设置，你需要检查系统或IDE的环境变量配置。

3. 检查Maven插件是否硬编码了端口 #

打开你的pom.xml，看看spring-boot-maven-plugin有没有配置固定的server.port，比如这样的代码：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <systemProperties>
            <systemProperty>
                <name>server.port</name>
                <value>8080</value>
            </systemProperty>
        </systemProperties>
    </configuration>
</plugin>

如果有这个配置，Maven启动时会强制设置端口为8080，覆盖你传入的VM参数，把这段配置删掉或者改成动态值即可。

4. 清理IntelliJ缓存 #

有时候IDE的缓存会导致配置不生效，试试这个操作：

• 点击File → Invalidate Caches...
• 勾选Invalidate and Restart，等待IDE重启后再重新启动应用。

按照上面的步骤排查，应该就能解决VM参数设置端口不生效的问题了！

内容的提问来源于stack exchange，提问作者Bhavya Arora