IDEA 多端口启动 Spring Boot 多实例操作总结

本文总结了在 IDEA 中，不修改项目代码、不改动配置文件，快速配置并同时启动 Spring Boot 项目多个实例的完整流程，方便开发环境下并行测试。

一、核心原理

Spring Boot 单个进程只能占用一个端口，要启动多实例，需满足两个核心条件：

1. 每个实例指定不同的服务端口
2. IDEA 配置中开启允许并行运行，支持同时启动多个实例

二、操作步骤（图文对应版）

1. 基础配置（修改单实例端口）

1. 打开 IDEA 右上角的「运行/调试配置」界面，选中你的 Spring Boot 启动类配置。
2. 点击右上角的「修改选项(M)」（快捷键 Alt+M），勾选 程序参数（也可选择 VM 选项，程序参数优先级更高）。
3. 在新增的「程序参数」输入框中，写入端口配置：

   --server.port=8080
   

   （示例中 8080 为默认端口，也可自定义）

2. 复制配置，创建多实例

1. 在左侧配置列表中，右键点击当前配置 → 选择「复制配置」。
2. 修改新配置的名称，如 FirstApplication-8081，方便区分不同实例。
3. 在新配置的「程序参数」中，写入不同的端口号：

   --server.port=8081
   

4. 关键配置：再次点击「修改选项(M)」，勾选 允许并行运行（不勾选则无法同时启动多个实例）。

3. 启动并验证多实例

1. 依次启动两个配置（FirstApplication 和 FirstApplication-8081）。
2. 分别访问两个端口地址，验证服务正常运行：
   • http://localhost:8080
   • http://localhost:8081

三、关键补充说明

1. 配置优先级：程序参数 --server.port=xxx > VM 选项 -Dserver.port=xxx > 项目配置文件（application.yml/properties），临时配置不会修改代码。
2. VM 选项写法：若习惯用 JVM 参数，可在「VM 选项」中写入：

   -Dserver.port=8081
   

3. 扩展多实例：如需启动更多实例，重复「复制配置→修改端口→勾选并行运行」步骤即可，端口号依次递增即可。

一句话速记

复制配置改端口，勾选并行运行，一键启动多实例。