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

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

• 多個微服務同時運行，需避免端口沖突；
• 團隊協(xié)作開發(fā)，統(tǒng)一規(guī)范不同服務的端口號；
• 測試負載均衡或集群部署；
• CI/CD 環(huán)境下動態(tài)傳入端口；
• 調(diào)試時快速切換配置而不修改源碼。

二、四種主流方式

方法一：通過配置文件設置端口（推薦用于常規(guī)開發(fā)）

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

支持的配置文件類型

操作步驟

打開你的項目資源目錄：

src/main/resources/

編輯 application.properties 文件，添加如下內(nèi)容：

server.port=8081

或者編輯 application.yml 文件：

server:
  port: 8081

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

注意事項

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

最佳實踐

# application.yml 示例：根據(jù)不同環(huán)境設置端口
spring:
  profiles:
    active: dev

---
spring:
  config:
    activate:
      on-profile: dev
server:
  port: 8081

---
spring:
  config:
    activate:
      on-profile: test
server:
  port: 9090

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

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

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

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

完整操作流程（含界面細節(jié)）

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

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

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

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

此時會出現(xiàn)輸入框，在其中填寫：

-Dserver.port=8082

點擊 Apply → OK

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

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

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

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

使用場景舉例

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

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

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

如何添加？

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

--server.port=8084

與 VM Options 的區(qū)別對比

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

方法四：通過環(huán)境變量設置端口（適合生產(chǎn)模擬與自動化）

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

在 IDEA 中模擬環(huán)境變量

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 中提前測試該行為，可極大提升部署穩(wěn)定性。

三、四大方式優(yōu)先級

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

記憶口訣：“外 > 內(nèi)，動 > 靜” —— 外部傳入 > 內(nèi)部寫死；動態(tài)傳參 > 靜態(tài)配置

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

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

操作步驟

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

優(yōu)勢

• 一鍵啟動整個微服務體系；
• 支持跨模塊聯(lián)合調(diào)試；
• 提升團隊協(xié)作效率。

五、常見問題與解決方案

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. 控制臺日志是否顯示最終使用的端口

六、各方法適用場景總結

七、技術延伸

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

@RestController
public class PortInfoController {

    @Value("${server.port}")
    private int port;

    @Autowired
    private 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 接口即可看到哪些配置源參與了決策。

以上就是IntelliJ IDEA啟動項目時配置端口的操作指南的詳細內(nèi)容，更多關于IDEA啟動項目配置端口的資料請關注腳本之家其它相關文章！

最新評論