🌟 一、為什么需要手動設置啟動端口？

默認情況下，Spring Boot 應用會使用 8080 端口啟動。但在以下場景中，我們必須自定義端口：

• 多個微服務同時運行，需避免端口沖突；
• 團隊協作開發，統一規范不同服務的端口號；
• 測試負載均衡或集群部署；
• CI/CD 環境下動態傳入端口；
• 調試時快速切換配置而不修改源碼。

🔧 二、四種主流方式

方法一：通過配置文件設置端口（推薦用于常規開發）

這是最基礎也是最常用的配置方式，適用于 Spring Boot 項目。

? 支持的配置文件類型

文件名	格式說明
application.properties	鍵值對格式，簡潔明了
application.yml	層級結構清晰，適合復雜配置

📝 操作步驟

1. 打開你的項目資源目錄：

   src/main/resources/
   

2. 編輯 application.properties 文件，添加如下內容：

   server.port=8081
   

   或者編輯 application.yml 文件：

   server:port: 8081
   

3. 保存文件后直接運行主類即可生效。

?? 注意事項

• 若未指定端口，默認使用 8080。
• 配置文件中的設置會被更高優先級的方式覆蓋（見后文“優先級”章節）。
• 推薦使用 .yml 格式以支持多 profile 配置（如 application-dev.yml, application-prod.yml）。

💡 最佳實踐

# application.yml 示例：根據不同環境設置端口
spring:profiles:active: dev---
spring:config:activate:on-profile: dev
server:port: 8081---
spring:config:activate:on-profile: test
server:port: 9090

然后在運行配置中添加程序參數：--spring.profiles.active=test

---

方法二：通過 VM Options 設置端口（適合臨時調試與多實例）

當你要在同一臺機器上啟動多個相同服務實例時，VM Options 是最實用的方式。

📌 關鍵點：新版 IDEA 默認隱藏部分高級選項，必須手動開啟！

🛠? 完整操作流程（含界面細節）

1. 點擊右上角運行配置下拉框 → 選擇 Edit Configurations…

2. 在左側選擇你的運行配置（通常是 Spring Boot 類型）

3. 查找右側是否有 “VM options:” 輸入框：

   • 如果沒有，請點擊下方按鈕：Modify Options
   • 彈出菜單后勾選 Add VM options

4. 此時會出現輸入框，在其中填寫：

   -Dserver.port=8082
   

5. 點擊 Apply → OK

6. 啟動項目，查看控制臺輸出確認端口已變更：

   Tomcat started on port(s): 8082 (http)
   

🖼? 新版 IDEA 界面提示（文字版）

• “Modify Options” 按鈕位于配置面板底部，圖標為齒輪或三個點。
• 勾選后，“VM options” 字段自動出現，支持 -Dkey=value 形式的 JVM 參數注入。

? 使用場景舉例

場景	配置示例
第一個實例	-Dserver.port=8081
第二個實例	-Dserver.port=8082
第三個實例	-Dserver.port=8083

可復制多個運行配置，分別設置不同端口，實現一鍵并行啟動。

---

方法三：通過 Program Arguments 設置端口（命令行風格）

與 VM Options 不同，這種方式是將參數傳遞給應用程序本身，而非 JVM。

📥 如何添加？

1. 進入 Run/Debug Configurations
2. 點擊 Modify Options
3. 勾選 Program arguments
4. 輸入：

   --server.port=8084
   

🔄 與 VM Options 的區別對比

維度	VM Options (-D)	Program Arguments (--)
作用對象	JVM 系統屬性	應用程序參數
語法	-Dkey=value	--key=value
是否影響其他系統屬性	是	否
Spring Boot 是否識別	? 是	? 是
優先級	更高	略低（但仍高于配置文件）

📝 注：兩者均可被 Spring Boot 正確解析，但 -D 方式更底層，可用于非 Spring 項目。

---

方法四：通過環境變量設置端口（適合生產模擬與自動化）

某些云平臺或容器化部署依賴環境變量來決定端口（如 Kubernetes、Docker）。

🧪 在 IDEA 中模擬環境變量

1. 進入 Run Configuration
2. 點擊 Modify Options
3. 勾選 Environment variables
4. 添加鍵值對：
   • Key: SERVER_PORT
   • Value: 8085

或者寫成一行：

SERVER_PORT=8085;JAVA_OPTS=-Xmx512m

💡 提示：Spring Boot 自動映射 SERVER_PORT 到 server.port

🌐 實際應用場景

# Docker 啟動時指定
docker run -e SERVER_PORT=8086 my-spring-app

在本地 IDEA 中提前測試該行為，可極大提升部署穩定性。

---

🏆 三、四大方式優先級

Spring Boot 對端口配置有明確的優先級順序，了解這一點至關重要：

優先級	配置方式	來源
1?? 最高	命令行參數	--server.port=9000
2??	VM Options	-Dserver.port=9000
3??	環境變量	SERVER_PORT=9000
4??	配置文件	application.yml / application.properties
5?? 最低	默認值	內嵌服務器默認端口（Tomcat: 8080）

? 記憶口訣：“外 > 內，動 > 靜” —— 外部傳入 > 內部寫死；動態傳參 > 靜態配置

---

🔄 四、進階：多實例并行啟動（Compound Configuration）

當你需要一次性啟動多個不同端口的服務（例如訂單服務 + 用戶服務 + 網關），可以使用 Compound Configuration 功能。

🧩 操作步驟

1. 打開 Edit Configurations
2. 點擊左上角 + 號 → 選擇 Compound
3. 命名（如：Microservices Cluster）
4. 在 Included configurations 中添加多個已有的運行配置
5. 每個子配置可獨立設置端口（通過 VM Options）
6. 點擊運行按鈕，所有服務將按順序啟動

🎯 優勢

• 一鍵啟動整個微服務體系；
• 支持跨模塊聯合調試；
• 提升團隊協作效率。

---

? 五、常見問題與解決方案

Q1：啟動時報錯 Address already in use: bind

說明端口已被占用。

解決方案：

Windows:

netstat -ano | findstr :8081
taskkill /PID <進程ID> /F

macOS/Linux:

lsof -i :8081
kill -9 <PID>

Q2：VM Options 選項找不到？

原因：新版 IDEA 默認隱藏。

? 正確做法：

• 必須先進入 Modify Options
• 主動勾選 Add VM options

Q3：端口改了但沒生效？

檢查：

1. 是否拼錯關鍵字（應為 server.port，不是 port.server）
2. 是否有多個配置文件沖突
3. 是否使用了 Profile 激活了另一個配置
4. 控制臺日志是否顯示最終使用的端口

---

📊 六、各方法適用場景總結

方法	適用階段	是否推薦	備注
配置文件	日常開發	? 強烈推薦	易維護，版本控制友好
VM Options	調試/多實例	? 推薦	靈活，不污染代碼
Program Arguments	命令行兼容	? 推薦	與腳本一致
環境變量	生產模擬	? 推薦	符合 DevOps 實踐
Compound 配置	微服務聯調	? 強烈推薦	提升開發效率

---

🧠 七、技術延伸

Spring Boot 使用 PropertySource 層次結構加載配置，形成一個有序的“配置棧”。你可以通過以下代碼驗證當前生效的端口來源：

@RestController
public class PortInfoController {@Value("${server.port}")private int port;@Autowiredprivate Environment env;@GetMapping("/port")public Map<String, Object> getPortInfo() {Map<String, Object> info = new HashMap<>();info.put("currentPort", port);info.put("propertySources", Arrays.toString(env.getPropertySources().stream().map(EnumerablePropertySource::getName).toArray()));return info;}
}

訪問 /port 接口即可看到哪些配置源參與了決策。